# See an agent's store collections

Source: https://docs.vlayers.ai/reference/hosting/describe-agent-store

`GET /v1/agents/{id}/store` · scope `workspace:read`

Lists the collections the agent's manifest declares for saved data, with each field's type and whether it is indexed or personal, how many documents and bytes each holds, and the limits your plan sets. A hosted agent's rooms keep no state: data that must outlive a request is saved here.

Requires an API key with the `workspace:read` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/store" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { collections } = await voicelayer.hosting.describeAgentStore('<agent-id>');
console.log(collections);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.describe_agent_store("<agent-id>")
print(result.collections)
```

## Response `200`

```json
{
  "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
  "collections": [
    {
      "name": "orders",
      "fields": [
        {
          "name": "status",
          "type": "string",
          "indexed": true
        },
        {
          "name": "phone",
          "type": "string",
          "indexed": true,
          "personal": true,
          "hashed": true
        }
      ],
      "docs": 12,
      "bytes": 4096
    }
  ],
  "totalBytes": 4096,
  "limits": {
    "maxDocBytes": 262144,
    "maxDocsPerCollection": 50000,
    "maxBytes": 1073741824
  }
}
```
