Read an agent's hosting settings
GET
Shows how an agent is hosted: the room size, how many warm rooms it keeps and the call capacity that gives, what your plan allows and what a room costs per hour, the agent's rooms, and anything standing in the way (a refused room, an empty wallet). isDefault is true when the agent has never saved settings and settings is what a new hosted agent starts with.
Requires an API key with the workspace:read scope.
apiKeyheader
AuthorizationBearer <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.
id*stringThe agent id.
The agent's settings, what the plan allows, its rooms and anything standing in the way
application/json- response
agentId*stringFormat
uuidsettings*isDefault*booleanclasses*array<>maxRooms*integerroomsInUse*integerconcurrentCalls*integerhourlyUsd*numberRange
0 <= valuerooms*array<>refusals*array<>walletEmpty*|nulllogRetentionDays*integerRange
1 <= valuelastActiveAt*|Format
date-timecurl "https://api.vlayers.ai/v1/agents/$AGENT_ID/hosting" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"Example Response
{ "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "settings": { "sizeClass": "small", "warmCount": 1, "maxInFlight": null, "sleepAfterIdleMinutes": null }, "lastActiveAt": null, "isDefault": false, "classes": [ { "sizeClass": "small", "allowed": true, "priceUsdPerHour": 0.03, "cpuGuaranteedMillicores": 250, "memoryMiB": 512, "maxInFlight": 8 }, { "sizeClass": "medium", "allowed": true, "priceUsdPerHour": 0.06, "cpuGuaranteedMillicores": 500, "memoryMiB": 1024, "maxInFlight": 16 } ], "maxRooms": 5, "roomsInUse": 1, "concurrentCalls": 8, "hourlyUsd": 0.03, "rooms": [ { "id": "room_0192f5d4-8b9c-7dae-8f3a-4b5c6d7e8f90", "workspaceId": "0192f5a1-5e6f-7a7b-8c8d-9e0f1a2b3c45", "environment": "prd", "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "versionId": "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012", "manifestHash": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef", "imageDigest": "sha256:0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef", "replica": 0, "sizeClass": "small", "purpose": "warm", "state": "ready", "runtimeClass": "kata-clh-4-2", "shimVersion": "1.0.0", "replacementOf": null, "createdAt": "2026-10-20T15:04:05.000Z", "endedAt": null } ], "refusals": [], "walletEmpty": null, "logRetentionDays": 14}