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

# Gérer les conversations

> Renommez une conversation ou supprimez une conversation et ses messages.

Ces opérations utilisent le token utilisateur court avec le scope `chat:write`. Un utilisateur ne peut modifier ou supprimer que ses propres conversations.

## Renommer une conversation

```bash theme={null}
curl --request PATCH \
  "$GPT_DE_BABI_BASE_URL/api/partners/v1/conversations/$CONVERSATION_ID" \
  --header "Authorization: Bearer $USER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"title":"Week-end à Assinie"}'
```

```json theme={null}
{
  "conversation_id": "0d1fc89d-bbb6-4826-a4e7-7e25738c2755",
  "title": "Week-end à Assinie",
  "updated_at": "2026-09-03T20:15:32.182Z"
}
```

Le titre est obligatoire, normalisé et limité à 255 caractères.

## Supprimer un tour

Un tour représente exactement un message utilisateur et la réponse GPT de Babi correspondante. Conservez le `turn_id` retourné lors de l'envoi du message. Après une restauration de l'historique, chaque message expose également ce `turn_id` afin de retrouver la paire à supprimer.

```bash theme={null}
export TURN_ID="UUID_DU_TURN"

curl --request DELETE \
  "$GPT_DE_BABI_BASE_URL/api/partners/v1/turns/$TURN_ID" \
  --header "Authorization: Bearer $USER_TOKEN"
```

```json theme={null}
{
  "deleted": true,
  "turn_id": "944bc91d-a2c9-4c7b-952a-a5237636bf75",
  "conversation_id": "0d1fc89d-bbb6-4826-a4e7-7e25738c2755",
  "user_message_id": "97d35d91-1cb7-4598-91d8-5ad4277e4fcf",
  "assistant_message_id": "33d983c5-4749-4e87-a318-4551f3daa933"
}
```

La suppression retire les deux messages de l'historique et reconstruit le contexte à partir des messages restants lors de la prochaine demande.

## Supprimer une conversation

```bash theme={null}
curl --request DELETE \
  "$GPT_DE_BABI_BASE_URL/api/partners/v1/conversations/$CONVERSATION_ID" \
  --header "Authorization: Bearer $USER_TOKEN"
```

```json theme={null}
{
  "deleted": true,
  "conversation_id": "0d1fc89d-bbb6-4826-a4e7-7e25738c2755"
}
```

<Warning>
  La suppression est définitive. Si la conversation ou le tour contient encore un traitement `queued` ou `running`, l'API répond avec `409 turn_in_progress`. Attendez l'événement `assistant.completed` ou `assistant.error`, puis recommencez.
</Warning>

Pour supprimer toutes les données d'un utilisateur partenaire, utilisez plutôt `DELETE /api/partners/v1/users/{external_user_id}` depuis votre backend avec les identifiants de l'application.