Calls
Subscription minutes, SMS and phone numbers use the matching plan allowance first. Only usage beyond that allowance is deducted from the wallet. Calls use a hybrid relay pipeline: the provider answers, plays the greeting, records caller speech, transcribes it (Deepgram), and your agent replies with text that is spoken back (TTS). The full transcript is saved automatically. Voice calls beyond the plan allowance cost $0.12 per minute in both directions. A 0-second call is free. A connected call has a one-minute minimum, then the actual duration, rounded up to the cent. JavaScript examples callhttps://api.agentline.cloud with fetch and a
Bearer al_live_... key. The Node package is not on npm.
Make an outbound call
from_number_id if
provided). Returns a call_id you use to control and inspect the call.
Outbound calls listen first. The pipeline classifies what picked up:
The message is the agent’s
voicemail_message when set. Without it, the
agent leaves one written from the call’s prompt. See Agents.Test without dialling anyone
Call the test line,+15555550100. Any +1 555 number works the same way:
area code 555 belongs to no real US or Canada number.
- Nothing is dialled or billed, and free trial minutes are not used.
- The call returns at once with
status: "completed"andtest: true. - The transcript has two lines: your agent’s greeting and the test line’s reply.
call.completedfires withtest: true, so webhooks and the relay can be tested too.
Control and inspect
Pushing context to a live call (relay mode)
If your backend (Hermes, OpenClaw, Claude Code, Codex, or another agent) needs to answer a live caller after acall.utterance event, use the persistent
Agent Relay or push context over HTTP. Every response is bound
to the exact turn_id from that event.
Send short facts, not a script. Include disposition:
context aloud. done, facts, and failed
close the turn and the voice rephrases those facts. progress only holds the
caller.
Returns delivered=true with status: "live" or "duplicate". A 409 means
the turn is stale or cancelled; a 410 means the call has ended. Never reuse
context from one turn for another.
GET /v1/calls/{id}/transcript returns {role, text, timestamp} turns.
role is human (caller) or agent (the AI agent). A call.utterance
conversation field uses user and assistant instead.