Events

API keys

Manage the keys that authenticate API requests. The full key value is shown once at creation — store it securely.

GET/workspace/api-keys workspace:admin

List API keys

List keys (prefix + scopes only; the secret is never returned again).

Example request

bash

curl https://api.bolchoai.in/v1/workspace/api-keys -H "Authorization: Bearer $VOXA_API_KEY"

POST/workspace/api-keys workspace:admin

Create API key

Create a key. The response includes the full key value exactly once.

Body

name*	string	Label for the key.
scopes	string[]	Permission scopes (default: agents:read, calls:write).

Example request

bash

curl -X POST https://api.bolchoai.in/v1/workspace/api-keys \
  -H "Authorization: Bearer $VOXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "scopes": [
    "..."
  ]
}'

Response

json

{ "id": "…", "name": "Server", "key": "vx_live_…", "prefix": "vx_live", "scopes": ["agents:read","calls:write"] }

DELETE/workspace/api-keys/{id} workspace:admin

Revoke API key

Revoke a key immediately.

Path parameters

id*

uuid

Key id.

Example request

bash

curl -X DELETE https://api.bolchoai.in/v1/workspace/api-keys/$ID \
  -H "Authorization: Bearer $VOXA_API_KEY"