# Modifier le résumé d'un appel

> Cet endpoint remplace le corps markdown du résumé d'appel généré par l'IA, par exemple après qu'un agent a relu le texte automatique et l'a corrigé.

`PATCH /v2/api/conversations/items/{id}/summary`

<Note>
**Scope requis :** `CONVERSATIONS_WRITE`
</Note>

Cet endpoint remplace le corps markdown du résumé d'appel généré par l'IA, par exemple après qu'un agent a relu le texte automatique et l'a corrigé.

Seuls les appels ont un résumé. Envoyer l'ID d'un SMS (`msg-*`) renvoie `400 INVALID_ITEM_ID`.

Lorsque le résumé que vous modifiez est celui qu'Allo affiche par défaut pour l'appel, Allo envoie un événement webhook [`summary.updated`](/fr/docs/webhooks/event-catalog#summaryupdated).

## Choisir un template

La plupart des appels n'ont qu'un seul résumé terminé, donc `template_key` peut être omis. Quand un appel en a plusieurs (par exemple `MARKDOWN_CLASSIC` et `MARKDOWN_SHORT_CALL`), `template_key` devient **obligatoire** : sinon la requête échoue avec `400 SUMMARY_TEMPLATE_KEY_REQUIRED`.

| Template | Cas d'usage |
|----------|-------------|
| `MARKDOWN_CLASSIC` | Résumé structuré complet avec des sections |
| `MARKDOWN_SHORT_CALL` | Résumé en un paragraphe pour les appels courts |

Si l'appel n'a aucun résumé terminé correspondant au `template_key` fourni, la requête renvoie `404 SUMMARY_TEMPLATE_NOT_FOUND`.

## Codes d'erreur

| Code | Statut | Quand |
|------|--------|-------|
| `INVALID_ITEM_ID` | 400 | Le préfixe de l'ID n'est pas `cll-` |
| `INVALID_REQUEST_BODY` | 400 | `content` est absent ou dépasse 100 000 caractères |
| `SUMMARY_TEMPLATE_KEY_REQUIRED` | 400 | L'appel a plusieurs templates terminés et `template_key` a été omis |
| `CONVERSATION_ITEM_NOT_FOUND` | 404 | L'appel n'existe pas, ou le propriétaire de l'API key n'y a pas accès |
| `SUMMARY_TEMPLATE_NOT_FOUND` | 404 | Aucun résumé terminé n'existe pour le `template_key` demandé |
