API Agents

Lisez les données d'agent pour un compte donné. Utilisez ces endpoints pour lister les agents, vérifier leur statut, et récupérer leur configuration.

L'API v1 est scopée par compte, tous les endpoints d'agent sont préfixés par /v1/accounts/{account_id}/. Voir Authentification pour obtenir votre clé API.

Lister les agents

Retourne tous les agents appartenant à un compte spécifique, ordonnés par nom.

GET /v1/accounts/{account_id}/agents

Paramètres de requête

Paramètre	Type	Défaut	Description
`limit`	integer	100	Nombre d'agents à retourner (max 100)
`offset`	integer	0	Nombre d'agents à sauter (pour la pagination)

Exemple

curl https://www.manivox.ai/api/v1/accounts/acc_01hx3k9z.../agents \
  -H "Authorization: Bearer la_YOUR_API_KEY"

Réponse, 200 OK

{
  "data": [
    {
      "id": "agt_01hx3k9z...",
      "name": "Customer Support FR",
      "description": "Gère les appels de support entrants en français",
      "status": "ACTIVE",
      "created_at": "2026-01-15T10:30:00+00:00"
    },
    {
      "id": "agt_01hx4m2p...",
      "name": "Sales Outbound EN",
      "description": null,
      "status": "ARCHIVED",
      "created_at": "2026-02-03T08:12:00+00:00"
    }
  ],
  "total": 2
}

Référence de l'objet agent

Champ	Type	Description
`id`	string	Identifiant unique de l'agent (format CUID2)
`name`	string	Nom lisible défini dans le dashboard
`description`	string \| null	Description optionnelle
`status`	enum	Voir les valeurs de statut ci-dessous, toujours UPPERCASE dans les réponses API
`created_at`	ISO 8601	Horodatage de création (UTC avec offset fuseau)

Valeurs de statut d'agent

Statut	Description
`ACTIVE`	L'agent est en service, il gère les appels dès qu'il a une version en ligne
`ARCHIVED`	L'agent est retiré, les appels sont rejetés ; désarchivez-le depuis le dashboard pour le remettre en service

Cas d'erreur

Statut	Corps	Cause
`404`	`{ "error": "Account not found" }`	L'ID de compte n'existe pas dans votre organisation
`401`	`{ "error": "Invalid API key" }`	En-tête `Authorization` absent ou invalide

Création et configuration des agents

La création d'agents, la configuration LLM/STT/TTS, et la conception de flux se font via le dashboard. L'API v1 est en lecture seule pour les agents, elle vous permet d'interroger par programme quels agents existent et leur statut, pour de l'automatisation ou du monitoring.

Cas d'usage de l'API Agents :

Vérifier qu'un agent est ACTIVE et dispose d'une version live avant de lui assigner un numéro
Construire un dashboard de statut ou alerter quand un agent passe inopinément en ARCHIVED
Synchroniser les IDs d'agents vers votre CRM ou outils internes

Authentification

Appels