Endpoints

Configure webhook and AI agent endpoints (Vapi, Retell, LiveKit, Custom SIP)

List endpoints

get

Retrieves all configured endpoints (webhooks and AI agents)

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

List of endpoints

application/json

401

Unauthorized - Invalid or missing API key

application/json

get

/endpoints

HTTPcURLJavaScriptPython

GET /v1/endpoints HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "Customer Support Agent",
    "type": "vapi",
    "url": "sip:[email protected]",
    "status": "active",
    "provider_config": {
      "assistant_id": "asst_abc123"
    },
    "created_at": "2024-01-15T10:30:00Z"
  }
]

Create endpoint

post

Creates a new endpoint for call routing. Supports multiple provider types:

• webhook: Custom HTTP endpoint receiving call events

• vapi: Vapi AI voice agent

• retell: Retell AI voice agent

• livekit: LiveKit real-time communication

• custom_sip: Custom SIP endpoint

For AI providers (vapi, retell, livekit), the SIP URI is auto-generated.

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Body

application/json

namestring · max: 100Required

typestring · enumRequiredPossible values:

urlstring · uriOptional

Required for webhook and custom_sip types

phone_number_idstring · uuidOptional

Optional phone number to attach during creation

Responses

201

Endpoint created

application/json

400

Bad request - Invalid parameters or request body

application/json

401

Unauthorized - Invalid or missing API key

application/json

post

/endpoints

HTTPcURLJavaScriptPython

POST /v1/endpoints HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "name": "Call Webhook",
  "type": "webhook",
  "url": "https://api.example.com/webhooks/calls"
}

Webhook EndpointVapi AI AgentRetell AI AgentLiveKit AgentCustom SIP

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Agent",
  "type": "webhook",
  "url": "https://example.com",
  "status": "active",
  "provider_config": {
    "api_key": "text",
    "assistant_id": "text",
    "agent_id": "text",
    "api_secret": "text",
    "room_name": "text",
    "username": "text",
    "password": "text"
  },
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-02-03T08:30:42.152Z",
  "updated_at": "2026-02-03T08:30:42.152Z"
}

Get endpoint details

get

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Path parameters

idstring · uuidRequired

Endpoint UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

200

Endpoint details

application/json

404

Resource not found

application/json

get

/endpoints/{id}

HTTPcURLJavaScriptPython

GET /v1/endpoints/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Agent",
  "type": "webhook",
  "url": "https://example.com",
  "status": "active",
  "provider_config": {
    "api_key": "text",
    "assistant_id": "text",
    "agent_id": "text",
    "api_secret": "text",
    "room_name": "text",
    "username": "text",
    "password": "text"
  },
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-02-03T08:30:42.152Z",
  "updated_at": "2026-02-03T08:30:42.152Z"
}

Delete endpoint

delete

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Path parameters

idstring · uuidRequired

Endpoint UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Responses

204

Endpoint deleted

404

Resource not found

application/json

delete

/endpoints/{id}

HTTPcURLJavaScriptPython

DELETE /v1/endpoints/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update endpoint

patch

Authorizations

BearerAuth

AuthorizationstringRequired

API key in format kros_live_xxxx for production or kros_test_xxxx for testing. Also accepts JWT tokens from Supabase Auth for dashboard sessions.

Path parameters

idstring · uuidRequired

Endpoint UUID

Header parameters

x-organization-idstring · uuidOptional

Organization UUID for multi-tenant context. Falls back to user's first organization if not provided.

Body

application/json

namestring · max: 100Optional

urlstring · uriOptional

statusstring · enumOptionalPossible values:

Responses

200

Endpoint updated

application/json

400

Bad request - Invalid parameters or request body

application/json

404

Resource not found

application/json

patch

/endpoints/{id}

HTTPcURLJavaScriptPython

PATCH /v1/endpoints/{id} HTTP/1.1
Host: api.krosai.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "name": "Updated Agent Name",
  "status": "active"
}

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Customer Support Agent",
  "type": "webhook",
  "url": "https://example.com",
  "status": "active",
  "provider_config": {
    "api_key": "text",
    "assistant_id": "text",
    "agent_id": "text",
    "api_secret": "text",
    "room_name": "text",
    "username": "text",
    "password": "text"
  },
  "organization_id": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-02-03T08:30:42.152Z",
  "updated_at": "2026-02-03T08:30:42.152Z"
}