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

# Changelog

> Changes to the Agentova public API and its official connectors

**1.0.0**

First stable version

The first stable version of the public API, at `https://core-api.agentova.ai/v1`:

* **Automations**: list, retrieve, pause and reactivate — `GET /automations`, `GET /automations/{id}`, `PATCH /automations/{id}`.
* **Runs**, for the whole workspace or for one automation — `GET /runs`, `GET /automations/{id}/runs`.
* **Leads** — `GET /leads`.
* **Webhooks** — `GET /webhooks`, `POST /webhooks`, `DELETE /webhooks/{id}` — for the `lead.created`, `run.completed` and `automation.status_changed` events, signed with the `X-Agentova-Signature` header.
* The official connectors: the Agentova app for Zapier, and the `n8n-nodes-agentova-ai` package 1.0.0 for n8n.

**If you built on a preview of the contract**, these points changed:

* The `social` and `crm` lead sources are no longer reserved: `social` is a prospect who sent their contact details in a private message after commenting a post, `crm` an incoming contact of a connected CRM for which an automation ran. Both fire `lead.created`.
* `GET /webhooks` returns the full `url` only for the subscriptions created with the calling key; for the others, `url` is reduced to its origin, since the path of a hook URL carries the connector's secret token.
* Revoking a key in **Paramètres → API** deletes, by default, the webhook subscriptions created with it; the admin can untick the box to keep them. A key is also revoked, with its subscriptions, when the admin who created it leaves the workspace or stops being an admin.
* CRM sources record `crm_event` runs: Customer.io for each contact it acts on, the other CRM sources when the workspace has a single such CRM automation.
* Error messages are in English. Error codes didn't change: keep branching on `code`.
* New error code `service_unavailable` (`503`), when the API is temporarily turned off. Meanwhile, no webhook delivery is created for the events that happen, and deliveries already in progress resume when the API is back.
* Automation names are built in English — “Comment replies — Support Agent” or, for a CRM source, “HubSpot contacts — Support Agent”, for example. The agent's name is unchanged.
* Runs of email automations have `trigger_type: email` instead of `message`.
* `custom_fields` no longer exposes internal keys, those starting with `_`.
* Request bodies are limited to 16 KB (`413 invalid_request` beyond).
* `PATCH /automations/{id}` answers within 8 seconds; when reactivating takes longer, the final status arrives as an `automation.status_changed` event.
* Pausing an email automation stops listening to the mailbox: emails received during the pause get no reply. Reactivating one whose mailbox another active agent already uses returns `422 automation_not_controllable` with `details.reason: account_in_use`.
* `automation.status_changed` is also sent when a failure takes an automation away (`error`), and when an automation comes back after its account is reconnected (`active`).
* Failed webhook deliveries are retried for about 27 and a half hours instead of one hour, and never scheduled more than 36 hours after the event was created: keep the event IDs you've seen for at least 48 hours. A subscription is disabled after 3 abandoned deliveries in a row **and** 72 hours of uninterrupted failures, or at once if its URL no longer passes the address checks. A `410 Gone` answer deletes the subscription, and `Retry-After` is honored on `429` and `503`. Deliveries carry `User-Agent: Agentova-Webhooks/1.0`.
* The contract file is now `openapi-v1.yaml`.


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