Proxy

Proxies authenticated HTTP requests to Voxity API endpoints.

Proxy HTTP requests to Voxity API

post

https://actions.voxity.aihttps://actions.dev.voxity.ai

/chat/proxy

Proxies authenticated HTTP requests to Voxity API endpoints. The endpoint validates user access to the organization, retrieves the stored API key, and forwards the request to Voxity with proper authentication. This allows browser clients to make Voxity API calls without exposing API keys.

Body

application/json

agentIdstring · min: 1Required

The organization/agent ID

Example: agent_123

urlstring · uriRequired

The full Voxity API URL to proxy to. Must start with one of: https://api.voxity.ai, https://api.dev.voxity.ai, https://actions.voxity.ai, or https://actions.dev.voxity.ai

Example: https://api.voxity.ai/v1/customers/cust_123

methodstring · enumOptional

HTTP method for the request

Default: GETExample: GETPossible values:

bodyanyOptional

Request body to forward to Voxity API

Example: {"name":"John Doe"}

Responses

200

Proxy response from Voxity API

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

post

/chat/proxy

HTTPcURLJavaScriptPython

POST /chat/proxy HTTP/1.1
Host: actions.voxity.ai
Content-Type: application/json
Accept: */*
Content-Length: 155

{
  "agentId": "agent_123",
  "url": "https://api.voxity.ai/v1/customers/cust_123",
  "method": "GET",
  "body": {
    "name": "John Doe"
  },
  "headers": {
    "X-Custom-Header": "value"
  }
}

{
  "status": 200,
  "data": {
    "id": "cust_123",
    "name": "John Doe"
  },
  "headers": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}