Skip to content

ICalls

2026-04-01 draft

/ICalls/v20260401/

Receive and manage incoming calls. Verified bots only.

Authentication required

All endpoints require Authorization: Bot <token> header. Get a token →

POST /ICalls/v20260401/Accept Privileged Connect

Accepts an incoming call. Returns a LiveKit room token for joining the call audio. The bot must be the callee.

Request Body AcceptCallRequest

Field Type
callId
uuid

Response AcceptCallResponse

Field Type
token string
roomName string
callerId uuid
audioBaseUrl string

Errors

Status Code Description
400 accept_failed Failed to accept call.
400 not_ringing Call is not in ringing state.
403 not_callee This call is not directed at this bot.
403 not_verified This endpoint requires a verified bot.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"callId":"..."}' \
     https://gateway.argon.zone/ICalls/v20260401/Accept
POST /ICalls/v20260401/Reject Privileged Connect

Rejects an incoming call with an optional reason.

Request Body RejectCallRequest

Field Type
callId
uuid
reason
string | null

Response RejectCallResponse

Field Type
rejected boolean

Errors

Status Code Description
403 not_callee This call is not directed at this bot.
403 not_verified This endpoint requires a verified bot.

Example

curl -X POST \
     -H "Authorization: Bot YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"callId":"...","reason":null}' \
     https://gateway.argon.zone/ICalls/v20260401/Reject
GET /ICalls/v20260401/Ringing Privileged Connect

Lists all currently ringing calls for the bot.

Response RingingCallsResponse

Field Type
calls RingingCall[]
↳ callId uuid
↳ callerId uuid

Errors

Status Code Description
403 not_verified This endpoint requires a verified bot.

Example

curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://gateway.argon.zone/ICalls/v20260401/Ringing