I-i-stem

POST /v1/call/trigger

Changed on

Triggers an immediate outbound call using the specified AI agent. The call is queued and processed asynchronously.

Request

Request body

agent_idstring uuid required

The UUID of the AI agent to conduct the call.

to_numberstring required

The destination phone number in E.164 format (e.g. +919876543210). Must include country code. Pattern: + followed by 10-15 digits.

metadataobject

Optional. Additional metadata to pass context to the agent (e.g. customer information, call objectives). Arbitrary key-value pairs.

Response

Call request accepted and queued

messagestring required

Human-readable status message.

statusstring required

Status value, e.g. accepted.

call_idstring uuid required

The unique identifier for the call (UUID). Use this to fetch call details later.

Example response

{
  "status": "accepted"
}

Changes