List attributes

GET

{target}

{identifier}

attributes

curl --request GET \
  --url https://api.attio.com/v2/{target}/{identifier}/attributes \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": {
        "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
        "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
        "attribute_id": "41252299-f8c7-4b5e-99c9-4ff8321d2f96"
      },
      "title": "Rating",
      "description": "Rating of the record out of 5",
      "api_slug": "Rating",
      "type": "rating",
      "is_system_attribute": false,
      "is_writable": true,
      "is_required": false,
      "is_unique": false,
      "is_multiselect": false,
      "is_default_value_enabled": false,
      "is_archived": false,
      "default_value": null,
      "relationship": null,
      "created_at": "2021-11-21T13:22:49.061Z",
      "config": {
        "currency": {
          "default_currency_code": null,
          "display_type": null
        },
        "record_reference": {
          "allowed_object_ids": null
        }
      }
    }
  ]
}

Authorizations

Authorization

string

header

required

This API uses OAuth 2.0 with the authorization code grant flow.

Path Parameters

target

enum<string>

required

Whether the attributes are on an object or a list.

Available options:

objects,

lists

Example:

"lists"

identifier

string

required

A UUID or slug to identify the object or list the attributes belong to.

Example:

"33ebdbe9-e529-47c9-b894-0ba25e9c15c0"

Query Parameters

limit

integer

The maximum number of results to return. See the full guide to pagination here.

Example:

10

offset

integer

The number of results to skip over before returning. See the full guide to pagination here.

Example:

5

show_archived

boolean

Whether archived attributes should be included in the results. See the full guide to archiving here.

Example:

true

Response

200 - application/json

Success

data

object[]

required

data.id

object

required

data.title

string

required

A title for the attribute, to be displayed across the app.

Example:

"Rating"

data.description

string | null

required

A text description of the attribute.

Example:

"A rating attribute"

data.api_slug

string

required

A unique slug for the attribute for use in API responses and URLs. Formatted in snake case.

Example:

"my-rating"

data.type

enum<string>

required

The type of the attribute.

Available options:

text,

number,

checkbox,

currency,

date,

timestamp,

rating,

status,

select,

record-reference,

actor-reference,

location,

domain,

email-address,

phone-number,

interaction,

personal-name

Example:

"text"

data.is_system_attribute

boolean

required

true if this is an Attio system-defined attribute, false if defined by a user or non-Attio system.

Example:

true

data.is_writable

boolean

required

Whether or not this attribute can be written to. Can only be false when is_system_attribute is true (user-defined attributes are always writeable). If false, this usually means the attribute is enriched by Attio.

Example:

true

data.is_required

boolean

required

When is_required is true, new records/entries must have a value for this attribute. If false, values may be null. This value does not affect existing data and you do not need to backfill null values if changing is_required from false to true.

Example:

true

data.is_unique

boolean

required

Whether or not new values for this attribute must be unique. Uniqueness restrictions are only applied to new data and do not apply retroactively to previously created data.

Example:

true

data.is_multiselect

boolean

required

Whether or not this attribute can have multiple values. Multiselect is only available on some value types.

Example:

true

data.is_default_value_enabled

boolean

required

Whether this attribute has a default value enabled. Must be true when is_required is true.

Example:

true

data.is_archived

boolean

required

Whether this attribute has been archived. Archived attributes are hidden from most UI, but can be restored either over the API or in workspace settings. See the guide on archiving and deletingfor more information.

Example:

false

data.default_value

object | null

required

The default value for this attribute. Static values are used to directly populate values using their contents. Dynamic values are used to lookup data at the point of creation. For example, you could use a dynamic value to insert a value for the currently logged in user. Which default values are available is dependent on the type of the attribute.

data.relationship

object | null

required

If this attribute is related to another attribute, this is an object that includes an id property that identifies the other attribute. null means no relationship exists. See the help center for more details about relationship attributes.

data.created_at

string

required

When this attribute was created.

Example:

"2022-11-21T13:22:49.061281000Z"

data.config

object

required

Additional, type-dependent configuration for the attribute.

Was this page helpful?

Update an object Create an attribute

curl --request GET \
  --url https://api.attio.com/v2/{target}/{identifier}/attributes \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": {
        "workspace_id": "14beef7a-99f7-4534-a87e-70b564330a4c",
        "object_id": "97052eb9-e65e-443f-a297-f2d9a4a7f795",
        "attribute_id": "41252299-f8c7-4b5e-99c9-4ff8321d2f96"
      },
      "title": "Rating",
      "description": "Rating of the record out of 5",
      "api_slug": "Rating",
      "type": "rating",
      "is_system_attribute": false,
      "is_writable": true,
      "is_required": false,
      "is_unique": false,
      "is_multiselect": false,
      "is_default_value_enabled": false,
      "is_archived": false,
      "default_value": null,
      "relationship": null,
      "created_at": "2021-11-21T13:22:49.061Z",
      "config": {
        "currency": {
          "default_currency_code": null,
          "display_type": null
        },
        "record_reference": {
          "allowed_object_ids": null
        }
      }
    }
  ]
}

Introduction

Tutorials

How-to guides

Endpoint reference

Authorizations

Path Parameters

Query Parameters

Response