# customAttributeSchemas

Query

Retrieve custom attribute schemas to interpret customAttributes values. Returns at most 1000 rows; this field is not paginated.

Available to agents as MCP tool `getCustomAttributeSchemas` — see [Read tools](/api/v2/docs/mcp/read-tools#get-custom-attribute-schemas).

## Arguments

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `entity` | [`CustomAttributeSchemaEntity!`](/api/v2/docs/types/custom-attribute-schema-entity) | Yes | — | Entity type to get schemas for (ITEM or CREATOR). |

## Returns

Returns [`[CustomAttributeSchema!]!`](/api/v2/docs/types/custom-attribute-schema).

## Examples

### List custom attribute schemas

Retrieve the schemas needed to interpret item or creator custom attributes.

```graphql
query CustomAttributeSchemasDefault($entity: CustomAttributeSchemaEntity!) {
  customAttributeSchemas(entity: $entity) {
    key
    name
    type
  }
}
```

Variables:

```json
{
  "entity": "ITEM"
}
```

Response — HTTP 200:

```json
{
  "data": {
    "customAttributeSchemas": [
      {
        "key": "links",
        "name": "Links",
        "type": "TEXT_LIST"
      },
      {
        "key": "post_summary",
        "name": "Post Summary",
        "type": "TEXT"
      },
      {
        "key": "sentiment",
        "name": "Sentiment",
        "type": "SINGLE_SELECT_V2"
      },
      {
        "key": "collections",
        "name": "Collections",
        "type": "MULTIPLE_SELECT_V2"
      }
    ]
  }
}
```