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 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 |