# collections

Query

List Collections (saved tag sets) for the current workspace, in the workspace's saved order. Returns at most 1000 rows; this field is not paginated.

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

## Arguments

This field takes no arguments.

## Returns

Returns [`[Collection!]!`](/api/v2/docs/types/collection).

## Examples

### List collections

Return every saved Collection (tag set) in the workspace.

```graphql
query CollectionsDefault {
  collections {
    id
    name
    itemCount
    createdAt
    updatedAt
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "collections": [
      {
        "id": "122321ce-843e-5b07-9f56-94323c0ae39e",
        "name": "Best Sellers",
        "itemCount": 3,
        "createdAt": "2024-12-31T21:00:00Z",
        "updatedAt": "2024-12-31T21:00:00Z"
      },
      {
        "id": "e51b749b-1344-535f-a4c5-f878b69d143b",
        "name": "Seasonal Picks",
        "itemCount": 0,
        "createdAt": "2024-12-31T22:00:00Z",
        "updatedAt": "2024-12-31T22:00:00Z"
      }
    ]
  }
}
```