# Changelog (/changelog)

Each entry lists breaking changes first, then additions. From now on, v1 only receives additive changes ([Versioning](/versioning)).

## 2026-11-16 [#2026-11-16]

### Breaking changes [#breaking-changes]

- [`GET /api/v1/agency/clients`](/api-reference/workspace/listAgencyClients) now requires the agency add-on on the calling workspace. Without it the call returns `403` [`permission_denied`](/errors/permission_denied). See [Agencies](/guides/agencies#finding-a-clients-workspace-id).
- The workspace CRM webhook is retired. `getWorkspaceWebhook` and `setWorkspaceWebhook` (`GET` and `PUT /api/v1/merchant/crm-webhook`) are removed, and **Settings → Developers → CRM webhook** is gone from the console. [Webhook endpoints](/webhooks/endpoints) are now the only workspace-wide webhook.
- Each saved workspace CRM URL was moved to a [webhook endpoint](/webhooks/endpoints) with the description "Migrated from CRM webhook", subscribed to `call.completed` and `call.escalated`, plus the `ticket.*` events if ticket sync was on. The endpoint has a **new** signing secret: it does not reuse your old CRM secret. To see or replace it, [rotate the secret](/webhooks/endpoints#rotate-the-signing-secret) in **Settings → Developers → Webhooks**, then update your receiver.
- Those deliveries now use the endpoint envelope (`id`, `type`, `apiVersion`, `createdAt`, `data`) and are signed with [Standard Webhooks](/webhooks/verify-signatures) headers. `X-Signature-SHA256` is still sent, but it is keyed with the new `whsec_…` secret.
- Ticket events (`ticket.*`) now go only to webhook endpoints. They are no longer sent to a ticket's campaign or agent webhook URL, to a user's saved URL or to the workspace URL, and the `ticketWebhookSyncEnabled` setting is removed. Subscribe an endpoint to `ticket.*` to keep receiving them.
- A call without a campaign or agent webhook URL is no longer sent to a URL saved by the user who created the call or the lead. See [Campaign and agent webhooks](/webhooks/campaign-agent-webhooks).

## 2026-11-15 [#2026-11-15]

This release was the last one before general availability, and it includes breaking changes. Read **Breaking changes** before you upgrade an existing integration.

### Breaking changes [#breaking-changes-1]

**API keys and authentication**

- API keys get `403` on every `/auth/*` route, including `GET /auth/me`. To find out which workspace a key belongs to, call [`GET /api/v1/workspace`](/guides/workspace-usage).
- API keys only work on the endpoints listed in the [API reference](/api-reference), under `/api/v1`. Any other route, including console-only routes and the `/platform/v1` alias, refuses keys with `403` [`api_key_route_forbidden`](/errors/api_key_route_forbidden). See [Authentication](/authentication).
- A key acts with its creator's **current** role, so a manager who is made a lead now has keys that act as a lead. If the creator is deleted, suspended or blocked, or moves to another workspace, the key falls back to the workspace's primary manager. Each fallback is written to the audit log ([Keys belong to the workspace](/authentication#keys-belong-to-the-workspace)).

**Status codes and error codes**

Errors now carry a dedicated `error.code`, and some status codes changed:

| Situation | Before | Now |
| --- | --- | --- |
| Number is on the do-not-call list | `400` | `409` [`number_on_dnc`](/errors/number_on_dnc) |
| Campaign is not running (`callNow`, `callLeadNow`, `createCall`, resume) | `400` | `409` [`campaign_not_running`](/errors/campaign_not_running) |
| Calling minutes used up | `400` | `402` [`payment_required`](/errors/payment_required) |
| Campaign's daily call cap reached | `429` `rate_limit_exceeded` | `429` [`campaign_daily_cap_reached`](/errors/campaign_daily_cap_reached) |

Other calling refusals now have their own codes: [`concurrent_call_limit_reached`](/errors/concurrent_call_limit_reached) (429), [`carrier_capacity_reached`](/errors/carrier_capacity_reached) (409), [`campaign_call_limit_reached`](/errors/campaign_call_limit_reached) (409), [`campaign_dial_busy`](/errors/campaign_dial_busy) (409), [`campaign_no_eligible_leads`](/errors/campaign_no_eligible_leads) (409), [`campaign_leads_need_confirmation`](/errors/campaign_leads_need_confirmation) (409), [`campaign_not_ready`](/errors/campaign_not_ready) (422), [`lead_has_no_campaign`](/errors/lead_has_no_campaign) (422), [`dial_rejected`](/errors/dial_rejected) (400) and [`dial_failed`](/errors/dial_failed) (502). Errors for a missing resource now name it, for example [`campaign_not_found`](/errors/campaign_not_found) or [`lead_not_found`](/errors/lead_not_found), where they used to return `resource_not_found`. [All error codes](/errors#all-error-codes) lists every code.

**Response shapes**

- `callNow` and `callLeadNow` now wrap the new call in a `call` object. Read `call.id` and `call.status`.
- `createLead` and `updateLead` normalise phone numbers to E.164 and refuse numbers they cannot parse with `422` [`invalid_phone_number`](/errors/invalid_phone_number) ([Phone numbers](/guides/leads#phone-numbers)).
- The do-not-call list returns at most 500 entries per request, with `hasMore` ([Pagination](/pagination)).

**Validation**

- Agent `config` values are validated. A known key with a bad value returns `422` [`parameter_invalid`](/errors/parameter_invalid) with `param` set to the config path. Unknown keys are dropped, not refused ([Agents](/guides/agents#config-reference)).
- `POST /calls` refuses unknown body fields with `422`.
- Agent `config` is limited to 512 KB (`413` [`payload_too_large`](/errors/payload_too_large)) and 16 levels of nesting. This applies to create, update and import.
- Agent saves now refuse, with `422` `parameter_invalid`:
  - tool URLs and `post_call_webhook.url` that are not public `http(s)` addresses;
  - a `tools[].config.tool_id` that is not a tool in your workspace;
  - a `config.stt` provider that is not available.

  Import drops such values with a warning instead ([Import agents](/migrate/import-agents)).
- During a call, an inline `api_request` tool only accepts a relative path under its saved `base_url` ([Inline tools](/guides/agents#inline-tools)).
- The `agent_not_published` code was removed. Go-live publishes a pending draft first and refuses with [`agent_state_blocked`](/errors/agent_state_blocked).

**Calls and idempotency**

- `POST /calls` dials once. It does not redial a call that was not answered, was busy or timed out, and a refused dial is not queued. A callback the agent books during the call is still placed ([One request, one dial](/guides/direct-calls#one-request-one-dial)).
- Responses that contain a one-time secret (webhook endpoint create and secret rotation) are never stored. Replaying the same `Idempotency-Key` returns `409` [`idempotency_key_reused`](/errors/idempotency_key_reused), not the secret again.
- A request body over 1 MB skips idempotency and runs normally ([Idempotency](/idempotency)).

**Webhooks**

- [`lead.created`](/webhooks/events#leadcreated-and-leadupdated) is sent only for leads added one at a time: `createLead`, the console form and lead sources. Spreadsheet imports, campaign uploads and leads made automatically do not send it.
- Test events and redeliveries are limited to 10 per endpoint per minute (`429` `rate_limit_exceeded`).

**WhatsApp**

- The public WhatsApp endpoints now live under `/api/v1/whatsapp`, and their request and response fields are camelCase. Update the base path and field names if you used the earlier WhatsApp API ([WhatsApp](/guides/whatsapp)).

### Added [#added]

- **Error envelope:** every error returns `detail` plus an `error` object with `type`, `code`, `message`, `param`, `docUrl` and `requestId` ([Errors](/errors)).
- **Webhooks v2:** signed webhook endpoints per workspace, an event catalogue, test events, a delivery log, redelivery and secret rotation ([Webhooks](/webhooks)).
- **Direct calls:** `POST /calls` places one call without building a campaign. It only dials your workspace's home country and has a daily limit per workspace ([`destination_not_allowed`](/errors/destination_not_allowed), [`daily_call_limit_reached`](/errors/daily_call_limit_reached)). Also new: call transcript, recording, performance and daily counts ([Place and read calls](/guides/direct-calls)).
- **Agents:** create, update a draft, publish, start, pause, test calls, voices and tools, plus [agent import](/migrate/import-agents) from Vapi, Retell and Bland ([Agents](/guides/agents)).
- **Workspace and usage:** `GET /workspace` and `GET /usage` work with every key ([Workspace and usage](/guides/workspace-usage)).
- **Tickets:** list, create, update, notes, customer replies, categories and teams ([Tickets](/guides/tickets)).
- **WhatsApp:** send messages, read a message and list templates ([WhatsApp](/guides/whatsapp)).
- **Leads:** a lead fields catalogue and a callbacks list ([Leads](/guides/leads)).
- **Cursor pagination:** `listLeads` and `listCalls` accept a `cursor`. Page responses gain `nextCursor`, `hasMore` and `totalCapped` ([Pagination](/pagination)).
- **Idempotency:** create endpoints accept an `Idempotency-Key` header ([Idempotency](/idempotency)).
- **Rate-limit headers:** each key has its own limit, reported in `RateLimit-*` headers ([Rate limits](/rate-limits)).
- **API key limit:** a workspace can hold 20 unexpired keys by default ([`api_key_limit_reached`](/errors/api_key_limit_reached)).
- **Agency client list:** [`GET /api/v1/agency/clients`](/api-reference/workspace/listAgencyClients) lists an agency's client workspaces. Any agency key can call it if the key acts as a manager ([Agencies](/guides/agencies#finding-a-clients-workspace-id)).
- **Disabled-endpoint alert:** when a webhook endpoint is disabled automatically, the workspace gets one alert: in the console, plus email or WhatsApp if those alerts are on ([Automatic disabling](/webhooks#automatic-disabling)).
- **Developer hub in the console:** **Settings → Developers** manages API keys, webhook endpoints (including test events, the delivery log and redelivery) and the CRM webhook.
- Stopping a campaign that is already stopped now succeeds.