curl -X POST https://api.moustacheai.com/api/v1/responses/reset \
-H "Authorization: Bearer MON_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"companyIdentifier": "CLIENT_123",
"agentUUID": "28ce3b2d-5791-4905-8d66-123456789abc"
}'
{
"success": true,
"deletedCount": 12,
"message": "Conversation reset successfully"
}
Conversations
Réinitialiser une conversation
POST
/
api
/
v1
/
responses
/
reset
curl -X POST https://api.moustacheai.com/api/v1/responses/reset \
-H "Authorization: Bearer MON_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"companyIdentifier": "CLIENT_123",
"agentUUID": "28ce3b2d-5791-4905-8d66-123456789abc"
}'
{
"success": true,
"deletedCount": 12,
"message": "Conversation reset successfully"
}
Équivalent du bouton « Réinitialiser la conversation » du chatbot. Les messages échangés entre ce client et cet agent sont masqués : l’historique revient vide et l’agent ne se souvient plus des échanges précédents. La question suivante repart d’une conversation vierge.
Paramètres
string
required
Identifiant du client (même valeur que pour
/responses), 100 caractères max.string
required
UUID de l’agent (assistant) dont on réinitialise la conversation.
Comportement
- Idempotent : réinitialiser une conversation déjà vide renvoie aussi 200, avec
deletedCountà0. - Pas une suppression : les messages restent visibles dans la console Moustache AI, marqués comme supprimés par l’utilisateur. Seuls les messages sont concernés : les informations du client enregistrées via
/customerssont conservées. - Même client, même conversation : si le même identifiant est utilisé dans le chatbot intégré (identité vérifiée), la conversation y est aussi réinitialisée.
- Réponse en cours : tant qu’une réponse de
POST /api/v1/responsesest en cours de génération pour cette conversation, la réinitialisation est refusée (409). Attendez la fin de la réponse (marqueur:EOS:en mode stream, réception du JSON sinon), puis réessayez. Un 409 peut encore survenir quelques instants après:EOS:, le temps que le serveur finalise la réponse : réessayez avec un délai croissant (1 s, 2 s, 4 s…). Si la génération a été interrompue côté serveur, le blocage est levé au plus tard au bout de 5 minutes. À l’inverse, une question envoyée pendant une réinitialisation attend qu’elle soit terminée avant d’être traitée.
Réponses
| Code | Corps JSON |
|---|---|
| 200 | { "success": true, "deletedCount": 12, "message": "Conversation reset successfully" } |
| 400 | { "error": "Invalid JSON body" } ou { "error": "Invalid request body", "details": [ … ] } |
| 401 | { "error": "Provide Auth via Authorization with …" } |
| 404 | { "error": "Unauthorized: Assistant not found for your company" } ou { "error": "Customer not found" } |
| 409 | { "error": "Conversation reset impossible: a response is still being generated" } |
| 500 | { "error": "Internal Server Error" } |
deletedCount compte tous les éléments masqués de la conversation, y compris les étapes internes de l’agent (appels d’outils) : il peut dépasser le nombre de messages renvoyés par l’historique.
Un agent d’une autre société, désactivé ou supprimé renvoie 404, de même qu’un companyIdentifier inconnu pour votre société : l’API ne confirme jamais l’existence d’une conversation qui ne vous appartient pas.
curl -X POST https://api.moustacheai.com/api/v1/responses/reset \
-H "Authorization: Bearer MON_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"companyIdentifier": "CLIENT_123",
"agentUUID": "28ce3b2d-5791-4905-8d66-123456789abc"
}'
{
"success": true,
"deletedCount": 12,
"message": "Conversation reset successfully"
}
Was this page helpful?