Passer au contenu principal
L’API publique d’Agentova (v1) vous donne accès aux automatisations, aux leads et aux exécutions de votre espace de travail, et vous permet de mettre en pause ou de réactiver des automatisations. Elle vous prévient aussi en temps réel, par webhook, quand un lead arrive, qu’une exécution se termine ou que le statut d’une automatisation change.
Vous n’êtes pas développeur ? Les onglets Zapier et n8n sont des guides pas à pas pour utiliser Agentova dans ces outils, sans écrire de code.
L’API s’appelle depuis un serveur : elle s’authentifie avec une clé secrète et ne répond pas aux appels faits depuis un navigateur web (pas de CORS).

​
Routes

Lister les automatisations

GET /automations — toutes les automatisations de l’espace de travail, filtrées par statut, par type ou par agent.

Lire une automatisation

GET /automations/{id} — une automatisation et son statut actuel.

Changer le statut d'une automatisation

PATCH /automations/{id} — mettre en pause ou réactiver une automatisation.

Lister les exécutions

GET /runs — ce qu’ont fait vos automatisations, sur tout l’espace de travail.

Lister les leads

GET /leads — les leads captés par votre espace de travail, tous sous la même forme.

Lister les abonnements webhook

GET /webhooks — les abonnements de l’espace de travail, actifs et désactivés.

Créer un abonnement webhook

POST /webhooks — recevoir lead.created, run.completed ou automation.status_changed.

Supprimer un abonnement webhook

DELETE /webhooks/{id} — ne plus recevoir d’événements à cette adresse.
L’onglet Référence de l’API documente aussi GET /automations/{id}/runs, les exécutions d’une seule automatisation.
La v1 ne crée ni ne supprime d’automatisation, et ne permet pas de déclenchement manuel. C’est un contrat stable, volontairement restreint : ce sur quoi vous vous appuyez aujourd’hui continue de fonctionner — voir Versions.

​
Bien démarrer

Démarrage rapide

Créez une clé API, faites votre premier appel et recevez un vrai webhook en moins de 10 minutes.

Concepts

Les automatisations, les sources de leads et les exécutions que couvre l’API — et ce qu’elle ne couvre pas.

Webhooks et signatures

Livraisons, nouveaux essais, et comment vérifier une signature, avec un vecteur de test.

Sécurité

Conserver et remplacer les clés, secrets des webhooks, durée de conservation des données.

​
Comment cette documentation est construite

L’onglet Référence de l’API n’est pas écrit à la main : il est généré depuis le contrat OpenAPI d’Agentova, téléchargeable à l’adresse https://docs.agentova.ai/openapi/openapi-v1.yaml. La référence de l’API reste rédigée en anglais, comme le contrat OpenAPI dont elle est générée. Si un champ, un code d’erreur ou une route vous semble faux ici, c’est le contrat qu’il faut vérifier en premier : il fait foi. Chaque page existe aussi en Markdown : le menu en haut de page permet de la copier ou de l’ouvrir dans un assistant IA. La liste de toutes les pages, pour les outils d’IA, se trouve à l’adresse https://docs.agentova.ai/llms.txt.