> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verbeo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Verbeo REST API overview

> A complete reference for the Verbeo Campaigns REST API. Learn the base URL, request and response formats, versioning policy, rate limits, and how to get support.

The Verbeo REST API gives you programmatic control over your voice agents: the [assistants](/api-reference/assistants/overview) that answer and place calls, the [tools](/api-reference/tools/overview) they use during a call, the [phone numbers](/api-reference/phone-numbers/overview) they use, the [calls](/api-reference/calls/create) themselves, and the [campaigns](/api-reference/campaigns/overview) that run them in bulk. All resources are accessible over HTTPS and exchange data as JSON.

## Base URL

Every API request is sent to the following base URL:

```
https://api.verbeo.ai/v1
```

One endpoint is versioned on its own: [Create phone call](/api-reference/calls/create) is `POST https://api.verbeo.ai/v2/call`.

## Request format

The API follows REST conventions. Resources are addressed by URL, and the HTTP method describes the operation: `GET` to read, `POST` to create or trigger an action, `PUT` or `PATCH` to update, `DELETE` to remove. Send request bodies as JSON with the `Content-Type: application/json` header.

```bash theme={null}
curl -X POST "https://api.verbeo.ai/v1/campaigns" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"campaign_name": "Spring Outreach", "agent_id": "...", "phone_number": "+15551234567", "contacts": [...]}'
```

## Conventions

Every Verbeo response uses one of two envelopes:

* **Success** — `{ "success": true, "data": ... }`. List endpoints add `pagination`. See [Responses](/api-reference/responses).
* **Error** — `{ "success": false, "error": { "code": "...", "message": "...", "details": [...] } }`. Branch on `error.code`, never on the human-readable message. See [Errors](/api-reference/errors) for the full code reference.

## Authentication

All requests require a Bearer token in the `Authorization` header. See [API authentication and keys](/api-reference/authentication) for full details.

## Versioning

The Verbeo API is currently at version 1.0. The API follows an additive compatibility policy: new fields may appear in responses without a breaking-change notice. Fields and endpoints will not be removed or renamed without advance notice.

## Rate limits

Rate limits are applied per workspace. The specific thresholds depend on your plan. Contact [support@verbeo.ai](mailto:support@verbeo.ai) to learn about your workspace limits or to request an increase.

## Support

| Channel | Details |
| - | - |
| Email | [support@verbeo.ai](mailto:support@verbeo.ai) |
| Documentation | [docs.verbeo.ai](https://docs.verbeo.ai) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.