See an agent's store collections

GET
/v1/agents/{id}/store

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.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The agent id.

Response Body

The collections the agent's manifest declares, what each holds and the limits

application/json
  1. response
agentId*string
Formatuuid
collections*array<>
totalBytes*integer
Range0 <= value
limits*
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/store" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "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  }}