Calls

Create Call

Make an outbound phone call from your AI agent.

Dials a real person or business from the agent's number. The agent holds the whole conversation on its own with its system prompt, voice and greeting (or this call's overrides). The call reaches a third party and is billed to the account at $0.12 per minute, first minute charged in full, so confirm with the user first. Not idempotent: every successful call dials again.

Prerequisites: an agent with an active number from buy_phone_number (HTTP 400 otherwise), plus remaining subscription minutes or at least $0.50 of wallet balance (HTTP 402 otherwise). Included minutes are used first; only uncovered call time is charged to the wallet.

Returns right after dialing with the call id (call_...), agent_id, from_number, to_number, direction, status and started_at; the call runs on its own. Check get_call_details for progress and call get_call_transcript once status is completed.

post/v1/calls

Request

  • Base URL: https://api.agentline.cloud
  • URL: https://api.agentline.cloud/v1/calls
  • Auth: HTTP bearer

Request body

agent_idstring required

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

to_numberstring required

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

system_promptstring nullable

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_greetingstring nullable

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_idstring nullable

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

from_number_idstring nullable

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

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.