# Update call summary

> Replace the markdown content of a call's AI-generated summary. Only call items have summaries — passing an SMS ID ( msg- ) returns 400 INVALID ITEM ID . If…

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

<Note>
**Required scope:** `CONVERSATIONS_WRITE`
</Note>

Use this endpoint to replace the markdown body of a call's AI-generated summary, for example, after an agent reviews the auto-generated text and corrects it.

Only call items have summaries. Passing an SMS ID (`msg-*`) returns `400 INVALID_ITEM_ID`.

When the summary you edit is the one Allo shows by default for the call, Allo sends a [`summary.updated`](/docs/webhooks/event-catalog#summaryupdated) webhook event.

## Choosing a template

Most calls have a single completed summary, so `template_key` can be omitted. When a call has more than one completed summary (e.g., both `MARKDOWN_CLASSIC` and `MARKDOWN_SHORT_CALL`), `template_key` is **required**, otherwise the request fails with `400 SUMMARY_TEMPLATE_KEY_REQUIRED`.

| Template | Use case |
|----------|----------|
| `MARKDOWN_CLASSIC` | Full structured summary with sections |
| `MARKDOWN_SHORT_CALL` | One-paragraph summary for short calls |

If the call has no completed summary matching the supplied `template_key`, the request returns `404 SUMMARY_TEMPLATE_NOT_FOUND`.

## Error codes

| Code | Status | When |
|------|--------|------|
| `INVALID_ITEM_ID` | 400 | The ID prefix isn't `cll-` |
| `INVALID_REQUEST_BODY` | 400 | `content` is missing or exceeds 100,000 characters |
| `SUMMARY_TEMPLATE_KEY_REQUIRED` | 400 | The call has multiple completed templates and `template_key` was omitted |
| `CONVERSATION_ITEM_NOT_FOUND` | 404 | The call doesn't exist or the API key's owner has no access to it |
| `SUMMARY_TEMPLATE_NOT_FOUND` | 404 | No completed summary exists for the requested `template_key` |
