Answer a call

POST

/v1/calls/{id}/answer

const url = 'https://app.mondochat.io/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/answer';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://app.mondochat.io/v1/calls/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/answer \
  --header 'Authorization: Bearer <token>'

The callee answers a ringing call. The call becomes active and the response carries what the callee needs to join the Agora channel. Takes a session token. See https://docs.mondochat.io/guides/calls/.

Authorizations

session

Parameters

Path Parameters

required

string format: uuid

Responses

200

Successful Response

application/json

CallJoin

What a client needs to join the call’s Agora channel.

object

agora_app_id

required

Agora App Id

The Agora app id to join with.

string

call

required

Call

The call.

object

answered_at

Any of:

string
null

string format: date-time

callee_id

required

Callee Id

The user who is called.

string format: uuid

caller_id

required

Caller Id

The user who started the call.

string format: uuid

conversation_id

required

Conversation Id

The conversation the call belongs to.

string format: uuid

end_reason

Any of:

string
null

string

ended_at

Any of:

string
null

string format: date-time

required

The call’s id.

string format: uuid

started_at

required

Started At

When the call was started.

string format: date-time

state

required

State

ringing until answered, then active; missed, declined and busy end it unanswered, ended after it was answered.

string

Allowed values: ringing active ended missed declined busy

video

Video

How the callee’s client rings; it changes nothing else.

boolean

channel

required

Channel

The Agora channel of the call.

string

expires_at

required

Expires At

When the token stops working.

string format: date-time

peer_uid

required

Peer Uid

The other participant’s uid. React only to this uid in the channel.

integer

rtc_token

required

Rtc Token

The Agora token for this channel and uid.

string

uid

required

Uid

The caller’s numeric Agora uid.

integer

Example

{
  "agora_app_id": "0123456789abcdef0123456789abcdef",
  "call": {
    "callee_id": "0199d6a0-1000-7000-8000-000000000002",
    "caller_id": "0199d6a0-1000-7000-8000-000000000001",
    "conversation_id": "0199d6a0-2000-7000-8000-000000000001",
    "id": "0199d6a0-5000-7000-8000-000000000001",
    "started_at": "2026-11-01T09:30:00Z",
    "state": "ringing",
    "video": true
  },
  "channel": "0199d6a0-5000-7000-8000-000000000001",
  "expires_at": "2026-11-01T13:30:00Z",
  "peer_uid": 1002,
  "rtc_token": "example-rtc-token",
  "uid": 1001
}

4XX

Problem

application/problem+json

An RFC 9457 problem: the body of every error answer.

object

code

required

The stable error code to branch on, such as policy_denied.

string

detail

What went wrong this time, when there is more to say.

string | null

errors

For validation, one entry per invalid field.

Array<object>

One invalid field.

object

loc

The path to the field.

array

msg

What is wrong with it.

string

instance

The path of the request.

string

reason

For policy_denied and limit_reached, the rule or limit that refused the request; for forbidden, a short cause such as you_blocked; for banned, temporary when the ban expires.

string

status

required

The HTTP status code.

integer

title

required

A short summary of the problem.

string

type

required

A URL that names the problem, https://app.mondochat.io/problems/<code>.

string

Example

{
  "code": "policy_denied",
  "detail": null,
  "instance": "/v1/conversations/0199d6a0-2000-7000-8000-000000000001",
  "reason": "pins",
  "status": 403,
  "title": "Policy denied",
  "type": "https://app.mondochat.io/problems/policy_denied"
}