ICalls

2026-04-01 draft

/api/bot/ICalls/v20260401/

Receive and manage incoming calls. Verified bots only.

Authentication required

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

POST /api/bot/ICalls/v20260401/Accept Privileged ConnectVoice

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 string

Response AcceptCallResponse

Field Type
roomName string
token 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://api.argon.gl/api/bot/ICalls/v20260401/Accept
POST /api/bot/ICalls/v20260401/Reject Privileged ConnectVoice

Rejects an incoming call with an optional reason.

Request Body RejectCallRequest

Field Type
callId string
reason string

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":"..."}' \
     https://api.argon.gl/api/bot/ICalls/v20260401/Reject
GET /api/bot/ICalls/v20260401/Ringing Privileged ConnectVoice

Lists all currently ringing calls for the bot.

Response RingingCallsResponse

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

Errors

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

Example

$ curl -X GET \
     -H "Authorization: Bot YOUR_TOKEN" \
     https://api.argon.gl/api/bot/ICalls/v20260401/Ringing