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

# Réinitialiser une conversation

Équivalent du bouton « Réinitialiser la conversation » du chatbot. Les messages échangés entre ce client et cet agent sont masqués : l’[historique](/conversations/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

<ParamField body="companyIdentifier" type="string" required>
  Identifiant du client (même valeur que pour
  [`/responses`](/conversations/envoyer)), 100 caractères max.
</ParamField>

<ParamField body="agentUUID" type="string" required>
  UUID de l’agent (assistant) dont on réinitialise la conversation.
</ParamField>

## 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 [`/customers`](/clients/creer) sont conservées.
* **Même client, même conversation** : si le même identifiant est utilisé dans le chatbot intégré ([identité vérifiée](/identite-verifiee)), la conversation y est aussi réinitialisée.
* **Réponse en cours** : tant qu’une réponse de [`POST /api/v1/responses`](/conversations/envoyer) est 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.

<RequestExample>
  ```bash cURL theme={null}
  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"
        }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "deletedCount": 12,
    "message": "Conversation reset successfully"
  }
  ```
</ResponseExample>


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