List custom objects for accounts

Lists the custom objects defined for accounts, a page at a time.

GET /accounts/{account_id}/custom_objects

cURL

cURL

curl -X GET "$EXSITED_BASE_URL/api/v4/accounts/ACC0001/custom_objects?limit=20" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

200

{
  "data": [
    {
      "created_by": "<unknown>",
      "created_on": "<string>",
      "custom_component": "<unknown>",
      "description": "<string>",
      "display_name": "<string>",
      "href": "<string>",
      "id": "<string>",
      "last_updated_by": "<unknown>",
      "last_updated_on": "<string>",
      "name": "<string>",
      "object": "<string>",
      "relation": "<string>",
      "use_in": "<string>"
    }
  ],
  "object": "<string>",
  "pagination": {
    "limit": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "prev_cursor": "<string>",
    "links": {
      "next": "<string>",
      "prev": "<string>"
    }
  },
  "url": "<string>"
}

Returns the custom objects under data, with pagination for the next page. Use a custom object’s co_ id to read this account’s instances of it.

The SDK samples get their client from credentials your app registers once when it starts, as shown in Authentication. To try the call here, click Try it, set host to your Exsited API host name and paste an access token from Get an access token.

Authorizations

Authorization · string · header · required

An access token from POST /api/v4/oauth2/token. The SDKs get and renew it for you.

Path Parameters

account_id · string · required

The account's id, such as ACC0001. Not its uuid.

Query Parameters

limit · integer

The most custom objects to return on one page.

Example:

20

cursor · string

The pagination.next_cursor from the previous page, to fetch the next page.

sort · string

The field to sort by, such as created_on. Prefix it with - for descending order, as in -created_on.

Response

200 - application/json

One page of custom objects.

data · object[]

Show child attributes

object · string

pagination · object

How to fetch the next page.

Show child attributes

url · string