Change or switch off an endpoint

PUT
/v1/endpoints/{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.

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

endpoint*string

The endpoint id: the first segment of its run.vlayers.ai URL.

Request Body

application/json
  1. body
enabled?boolean

False switches the endpoint off for every caller at once; true switches it back on.

reason?string

Why you are switching it off (at least 3 characters). Recorded on the endpoint.

Length3 <= length <= 500
monthlySpendCapUsd?|

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.

Range0 <= value <= 1000000
settings?

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.

Response Body

The agent's endpoints after the change

application/json
  1. response
endpoints*array<>
Example Request
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  }'
Example Response
{  "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        }      ]    }  ]}