Change or switch off an endpoint
Any of: switch the endpoint off (say why; the reason is recorded) or on again, set a monthly spend cap in US dollars (null removes it), and change one route's limits and settings. A setting above what your plan allows is refused with 422 and names the ceiling. An endpoint that VoiceLayer switched off cannot be switched back on here: appeal it with POST /v1/endpoints/{endpoint}/appeal.
Requires an API key with the workspace:write 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.
endpoint*stringThe endpoint id: the first segment of its run.vlayers.ai URL.
application/json- body
enabled?booleanFalse switches the endpoint off for every caller at once; true switches it back on.
reason?stringWhy you are switching it off (at least 3 characters). Recorded on the endpoint.
3 <= length <= 500monthlySpendCapUsd?|The most the endpoint's traffic may cost in a calendar month, in US dollars; requests past it are refused with limit. null removes the cap.
0 <= value <= 1000000settings?Settings per route kind (api, hook, mcp): request and response size, timeout, requests per second, concurrent streams, redirects to other sites, caching, and what happens to a response that is not machine content.
The agent's endpoints after the change
application/json- response
endpoints*array<>curl -X PUT "https://api.vlayers.ai/v1/endpoints/$ENDPOINT_ID" \ -H "Authorization: Bearer $VOICELAYER_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "monthlySpendCapUsd": 25 }'{ "endpoints": [ { "id": "x7k2p4q9m3vd", "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78", "environment": "prd", "enabled": true, "disabled": null, "monthlySpendCapUsd": 25, "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 } ] } ]}