# CallingBox

## Docs

- [API basics](https://docs.callingbox.io/api-overview.md): Base URL, authentication, endpoints, and request conventions.
- [Archive an agent](https://docs.callingbox.io/api-reference/archive-an-agent.md): Soft-delete the agent. Historical calls are preserved.
- [Attach a number to an agent](https://docs.callingbox.io/api-reference/attach-a-number-to-an-agent.md): Attach a phone number you own to this agent. For an inbound agent the number must not already be attached to a different inbound agent. For an outbound agent the number can also be used by other outbound agents as a caller ID.
- [Create a webhook endpoint](https://docs.callingbox.io/api-reference/create-a-webhook-endpoint.md): Register a webhook endpoint. CallingBox will POST signed payloads to `url` whenever a subscribed event fires. The returned `signing_secret` is shown only once. Store it securely and use it to verify the `CallingBox-Signature` header on inbound requests.
- [Create an agent](https://docs.callingbox.io/api-reference/create-an-agent.md): Create an inbound or outbound agent. Attach numbers at creation time (or later via `POST /v1/agents/{id}/numbers`). At most one inbound agent per number.
- [Detach a number from an agent](https://docs.callingbox.io/api-reference/detach-a-number-from-an-agent.md)
- [Dispatch an outbound call from an agent](https://docs.callingbox.io/api-reference/dispatch-an-outbound-call-from-an-agent.md): Dispatch an outbound AI phone call. The call is placed immediately and runs under the configuration of the referenced outbound agent (persona, instructions, voice, language, returns, tools, voicemail action). Per-call `instructions` replace the agent's default for this call. Per-call `from_number` m…
- [Get a call by ID](https://docs.callingbox.io/api-reference/get-a-call-by-id.md): Retrieve a single call by its UUID. Use this to poll for status and results.
- [Get a call's transcript](https://docs.callingbox.io/api-reference/get-a-calls-transcript.md): Return the ordered transcript segments captured during a call. Segments are persisted incrementally as the call runs, so you can poll this endpoint during an active call; the final segment list is available once the call reaches a terminal status.
- [Get a single delivery](https://docs.callingbox.io/api-reference/get-a-single-delivery.md)
- [Get a webhook endpoint](https://docs.callingbox.io/api-reference/get-a-webhook-endpoint.md)
- [Get an agent](https://docs.callingbox.io/api-reference/get-an-agent.md)
- [List agents](https://docs.callingbox.io/api-reference/list-agents.md): List all agents (inbound and outbound) for the authenticated organization.
- [List all calls](https://docs.callingbox.io/api-reference/list-all-calls.md): Returns all calls for the authenticated organization, ordered by creation time descending.
- [List supported event types](https://docs.callingbox.io/api-reference/list-supported-event-types.md)
- [List webhook deliveries](https://docs.callingbox.io/api-reference/list-webhook-deliveries.md): Inspect recent delivery attempts for debugging and replay.
- [List webhook endpoints](https://docs.callingbox.io/api-reference/list-webhook-endpoints.md)
- [List your phone numbers](https://docs.callingbox.io/api-reference/list-your-phone-numbers.md): Returns all active phone numbers owned by the authenticated organization.
- [Purchase a phone number](https://docs.callingbox.io/api-reference/purchase-a-phone-number.md): Acquire a phone number for your organization. Credits are charged immediately.
- [Replay a delivery](https://docs.callingbox.io/api-reference/replay-a-delivery.md): Resets the delivery to `pending` and schedules it for the next worker tick. The same event id is reused so consumers can dedupe with their existing idempotency store.
- [Rotate the signing secret](https://docs.callingbox.io/api-reference/rotate-the-signing-secret.md): Generate a new signing secret for this endpoint and return it once. Previous signatures stop verifying immediately, so schedule the rollout with your consumer.
- [Search available numbers](https://docs.callingbox.io/api-reference/search-available-numbers.md): Search for phone numbers available for purchase.
- [Set an agent's primary number](https://docs.callingbox.io/api-reference/set-an-agents-primary-number.md): The primary number is the default caller ID for outbound calls placed through this agent (and for inbound it represents the number the agent is most associated with). Must already be attached to the agent.
- [Update a webhook endpoint](https://docs.callingbox.io/api-reference/update-a-webhook-endpoint.md)
- [Update an agent](https://docs.callingbox.io/api-reference/update-an-agent.md): Update agent configuration. Only supplied fields are written. Use `null` on nullable fields (`persona`, `instructions`, `language`, `webhook_url`) to clear them.
- [API keys](https://docs.callingbox.io/dashboard/api-keys.md): Create and manage API keys for the CallingBox API.
- [Numbers](https://docs.callingbox.io/dashboard/numbers.md): Acquire and manage phone numbers for your CallingBox calls.
- [Usage and credits](https://docs.callingbox.io/dashboard/usage-and-credits.md): Track call usage, manage credits, and understand CallingBox billing.
- [Agents](https://docs.callingbox.io/guides/agents.md): Agents are the reusable primitive for inbound and outbound calls. Configure once, dispatch many times.
- [Call flow](https://docs.callingbox.io/guides/how-it-works.md): The call lifecycle from agent configuration to structured result.
- [In-call tools](https://docs.callingbox.io/guides/in-call-tools.md): Let the agent invoke your functions mid-call to look up data, check availability, or end the call.
- [Inbound calls](https://docs.callingbox.io/guides/inbound-calls.md): How inbound agents answer incoming calls on your phone numbers.
- [Outbound calls](https://docs.callingbox.io/guides/outbound-calls.md): Dispatch a call from an outbound agent. Request fields, overrides, and examples.
- [Events](https://docs.callingbox.io/guides/webhook-events.md): Every lifecycle event CallingBox emits and what each payload contains.
- [Retries and replay](https://docs.callingbox.io/guides/webhook-retries.md): How CallingBox retries failed deliveries and how to replay them.
- [Security](https://docs.callingbox.io/guides/webhook-security.md): Verify every incoming webhook with HMAC-SHA256.
- [Overview](https://docs.callingbox.io/guides/webhooks.md): Receive signed lifecycle events for every call.
- [Introduction](https://docs.callingbox.io/index.md): The API for AI phone calls. Configure an agent, dispatch a call, get structured JSON back.
- [Quickstart](https://docs.callingbox.io/quickstart.md): Create an agent and place your first AI phone call in under five minutes.
- [Call object](https://docs.callingbox.io/reference/call-object.md): Every field on the CallingBox call object.
- [Statuses and failures](https://docs.callingbox.io/reference/statuses-and-errors.md): Call status lifecycle and error handling for the CallingBox API.
- [Webhook delivery](https://docs.callingbox.io/reference/webhook-delivery-object.md): A single attempt (or attempt lifecycle) to POST an event to a URL.
- [Webhook endpoint](https://docs.callingbox.io/reference/webhook-endpoint-object.md): A destination URL that receives signed lifecycle events.
- [MCP Server](https://docs.callingbox.io/sdks/mcp.md): Use Callingbox from any MCP-compatible AI client (Cursor, Claude Desktop, ChatGPT) to place calls and manage numbers.
- [OpenClaw](https://docs.callingbox.io/sdks/openclaw.md): Register the hosted CallingBox MCP server with OpenClaw so its agents can place phone calls and manage numbers.
- [SDKs & tools](https://docs.callingbox.io/sdks/overview.md): Choose between the HTTP API, the Python SDK, the TypeScript SDK, and the CLI.
- [Python SDK](https://docs.callingbox.io/sdks/python.md): Install, authenticate, and use the CallingBox Python SDK for numbers and calls.
- [TypeScript SDK](https://docs.callingbox.io/sdks/typescript.md): Install, authenticate, and use the CallingBox TypeScript SDK for numbers and calls.
- [Skills](https://docs.callingbox.io/skills.md): Install the CallingBox skill into Cursor, Claude Code, and other coding agents for zero-to-one setup.
- [Structured results](https://docs.callingbox.io/structured-results.md): Define a returns schema on your agent and get typed JSON extracted from every call it handles.
- [CLI](https://docs.callingbox.io/tools/cli.md): Install, authenticate, and use the CallingBox command-line interface for local workflows, scripting, and CI.

## OpenAPI Specs

- [callingbox](https://docs.callingbox.io/openapi/callingbox.yaml)