Read an agent's hosting settings

GET
/v1/agents/{id}/hosting

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.

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 agent's settings, what the plan allows, its rooms and anything standing in the way

application/json
  1. response
agentId*string
Formatuuid
settings*
isDefault*boolean
classes*array<>
maxRooms*integer
roomsInUse*integer
concurrentCalls*integer
hourlyUsd*number
Range0 <= value
rooms*array<>
refusals*array<>
walletEmpty*|null
logRetentionDays*integer
Range1 <= value
lastActiveAt*|
Formatdate-time
Example Request
curl "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}