List an agent's published endpoints

GET
/v1/agents/{id}/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.

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 published endpoints: where callers reach them, who may call, the version answering, limits, keys and this month's spend

application/json
  1. response
endpoints*array<>
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/endpoints" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "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        }      ]    }  ]}