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](https://www.manivox.ai/docs/api/index) 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ètreTypeDéfautDescription   `limit`integer100Nombre d'agents à retourner (max 100) `offset`integer0Nombre 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
--------------------------

ChampTypeDescription   `id`stringIdentifiant unique de l'agent (format CUID2) `name`stringNom lisible défini dans le dashboard `description`string | nullDescription optionnelle `status`enumVoir les valeurs de statut ci-dessous, toujours UPPERCASE dans les réponses API `created_at`ISO 8601Horodatage de création (UTC avec offset fuseau) ### Valeurs de statut d'agent

StatutDescription   `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
------------

StatutCorpsCause   `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](https://www.manivox.ai/docs/agents/create). 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