List an agent's published endpoints
Shows the endpoints a hosted agent publishes at run.vlayers.ai: the URL callers use for each kind (api, hook, mcp), who may call it (anyone, an endpoint key, a signature, or OAuth), the version answering now and the one waiting for a ready room, the limits in force, the endpoint keys (never their secrets), the monthly spend cap and what the endpoint has spent this month. A public endpoint can be called by anyone, and its traffic is billed to your workspace.
Requires an API key with the workspace:read scope.
apiKeyAuthorizationBearer <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 published endpoints: where callers reach them, who may call, the version answering, limits, keys and this month's spend
application/json- response
endpoints*array<>curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/endpoints" \ -H "Authorization: Bearer $VOICELAYER_API_KEY"{ "endpoints": [ { "id": "x7k2p4q9m3vd", "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "environment": "prd", "enabled": true, "disabled": null, "monthlySpendCapUsd": null, "spentThisMonthUsd": 0.42, "routes": [ { "kind": "api", "url": "https://run.vlayers.ai/x7k2p4q9m3vd/api", "auth": "key", "servingVersion": 3, "pendingVersion": null, "settings": {}, "limits": { "maxRequestBytes": 10485760, "maxResponseBytes": 67108864, "timeoutMs": 30000, "requestsPerSecond": 50, "concurrentStreams": 50, "streamIdleMs": 300000 } } ], "keys": [ { "id": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67", "kind": "api", "name": "Partner integration", "preview": "vle_AbCd…wXyZ", "createdAt": "2026-10-20T15:04:05.000Z", "expiresAt": null, "lastUsedAt": null, "revokedAt": null } ] } ]}