AgentLine

List Agents List all AI voice agents configured on your account. Returns every AI phone agent you've created, including their system prompts, voice settings, and associated phone numbers. Useful for checking which agents are ready to make or receive calls. ### Responses: **200**: Successful Resp

Create Agent Create a new AI voice agent for telephony. Sets up a new AI phone agent with a custom system prompt, voice, and greeting. Once created, buy a phone number and attach it to this agent so it can make and receive calls autonomously. Fields: - name: Display name for the agent - syste

Get Agent Get details of a specific AI voice agent. Returns the agent's full configuration including system prompt, voice settings, greeting, and transfer number. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json **Output Schema:** ```json {} ``` **42

Update Agent Update an AI voice agent's configuration. Modify any combination of the agent's settings: system prompt, voice, greeting, transfer number, or voicemail message. Changes take effect on the next call the agent handles. Only include the fields you want to change — unset fields are preser

Delete Agent Delete an AI voice agent. Permanently removes the agent and detaches any phone numbers assigned to it. Detached numbers remain active on your account and can be reassigned to another agent. ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json

List Numbers List all phone numbers provisioned on your account. Returns every phone number you've bought for your AI agents, including which agent each number is assigned to, the number's status (active/released), and country. ### Responses: **200**: Successful Response (Success Response) Conte

Provision Buy a US phone number for your AI agent. Searches for and purchases a real US phone number from the telephony provider, then attaches it to the specified AI agent. Once attached, the agent can make outbound calls and receive inbound calls on this number. Each AI agent can only have ONE

List Messages List SMS messages sent and received by your AI agents. Returns message history with optional filters by AI agent or conversation. Each entry includes direction (inbound/outbound), phone numbers, message body, and delivery status. ### Responses: **200**: Successful Response (Success

Create Call Make an outbound phone call from your AI agent. Initiates a real phone call from the AI agent's phone number to the specified destination. The agent uses its configured system prompt, voice, and greeting to conduct the conversation autonomously. The AI agent handles the entire call —

List Calls List voice calls made by your AI agents. Returns call history with optional filters by agent or status. Each entry includes direction (inbound/outbound), duration, phone numbers, and current status. Filters: - agent_id: only calls for a specific AI agent - status: "initiated", "in-

Get Call Get full details of a specific voice call. Returns the call's metadata including direction, phone numbers, status, duration, AI agent configuration used, and the full conversation transcript between the AI agent and the caller. ### Responses: **200**: Successful Response (Success Respon

Get Transcript Get the full conversation transcript for a call. Returns the complete speech-to-text transcript of the phone call, with each turn labeled by role ("human" for the caller, "assistant" for the AI agent). Useful for reviewing what was said on the call, extracting information, or auditi

Hangup Call Hang up an active phone call. Programmatically terminates an in-progress voice call. Use this when the AI agent needs to end the conversation, or to force-stop a call that is no longer needed. The call's final transcript and billing are processed automatically after hangup. ### Respon

Push Call Context Push context into a LIVE relay-mode call (mid-call context injection). This is the required way for backend agents (Hermes, OpenClaw, etc.) to answer a live caller after a ``call.utterance`` event. Do your work, then POST facts here — do NOT only send the answer to WhatsApp/SMS/c

List Events Poll for telephony events from your AI agents. Returns pending events such as call completions, transcripts, and failures. Events are consumed on retrieval (one-time read) — once polled, they are automatically deleted from the mailbox. Your AI agent should call this endpoint periodica

Peek Events Peek at pending telephony events without consuming them. Returns a preview of queued events (call completions, transcripts) without removing them from the mailbox. Useful for checking if there are events to process before committing to retrieve them. ### Responses: **200**: Successfu

Get Balance Get your AI telephony account balance and rate card. Returns the current balance, currency, billing rates for calls and phone numbers, and how many call minutes or phone numbers the balance can cover. Use this to check affordability before making calls or buying numbers for your AI age

Get Expenditure Get a detailed expenditure breakdown for AI telephony usage. Shows total spend split by category (voice calls, phone number provisioning, top-ups, refunds) with counts and averages. Useful for tracking how much your AI agents are spending on phone calls and phone numbers. ### Resp

Get Available Voices List all available voice presets for AI phone agents. Returns named TTS (text-to-speech) voice presets that can be used when configuring AI agents or making phone calls. Each voice defines how your AI agent sounds on the phone. You can use a preset name (e.g. "female-1", "mal

Get Account Voice Get the current account-level default voice for AI phone agents. Returns which voice is used for all AI agents under this account unless overridden at the agent level or per-call. Controls how your AI agents sound during phone conversations. ### Responses: **200**: Successful R

Reset Account Voice Reset account voice to the system default. Removes the account-level voice override so all AI agents fall back to the system default voice during phone calls (unless they have their own voice_id configured). ### Responses: **200**: Successful Response (Success Response) Conte

Update Account Voice Set the account-level default voice for AI phone agents. This becomes the default voice for ALL AI agents under this account, controlling how they sound on phone calls. Individual agents or specific calls can still override this setting. Voice resolution priority: 1. Per-ca

Submit Feedback Submit feedback, report a bug, or request a feature. Use this endpoint to tell the AgentLine team about anything you encounter while using the platform: - **bug** — something is broken or not working as expected - **feature_request** — you wish a capability existed - **diffi

List Feedback List feedback you have submitted. Returns your feedback history with optional filters by category (bug, feature_request, difficulty, feedback) and status (open, acknowledged, in_progress, resolved, closed). Useful for tracking progress on bugs or feature requests you reported. ### R

Get Webhooks List the account's per-agent webhook configuration(s). Secrets are **masked**. Pass `agent_id` to inspect a single agent's webhook. The full secret is only ever shown once, on the POST that creates/replaces it. ### Responses: **200**: Successful Response (Success Response) Content-T

Set Webhook Create or replace an agent's webhook. The configured URL receives ALL of that agent's event types — call lifecycle (`call.received`, `call.completed`, `call.failed`), SMS (`sms.received`), and future events — as signed JSON POSTs. Each agent may have at most one webhook; POSTing again

Delete Webhook Remove an agent's webhook. No events for that agent will be delivered via HTTP afterwards; they remain available via GET /v1/events (the mailbox). ### Responses: **200**: Successful Response (Success Response) Content-Type: application/json **Output Schema:** ```json {} ``` **422*

Test Webhook Fire a signed `webhook.test` event to the agent's webhook. Uses the exact same event bus (publish_event) that real telephony events use, so a successful delivery confirms the entire pipeline is wired correctly. Returns 404 if no webhook is configured for the agent. ### Responses: **