Skip to main content
POST
Create Call

Authorizations

Authorization
string
header
required

AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...

Body

application/json
agent_id
string
required

ID of the AI agent making the call (e.g. 'agt_abc123')

to_number
string
required

Destination phone number in E.164 format (e.g. '+12125551234')

system_prompt
string | null

Per-call system prompt override. Replaces the agent's default prompt for this call ONLY. If omitted, the agent's default system_prompt is used.

initial_greeting
string | null

Per-call greeting override. Replaces the agent's default greeting for this call ONLY. If omitted, the agent's default initial_greeting is used.

voice_id
string | null

Override the TTS voice for this call: preset name (e.g. 'female-1') or Cartesia UUID

from_number_id
string | null

Specific phone number ID to call from; defaults to the agent's assigned number

Response

Successful Response