Allo

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

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.

TemplateUse case
MARKDOWN_CLASSICFull structured summary with sections
MARKDOWN_SHORT_CALLOne-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

CodeStatusWhen
INVALID_ITEM_ID400The ID prefix isn't cll-
INVALID_REQUEST_BODY400content is missing or exceeds 100,000 characters
SUMMARY_TEMPLATE_KEY_REQUIRED400The call has multiple completed templates and template_key was omitted
CONVERSATION_ITEM_NOT_FOUND404The call doesn't exist or the API key's owner has no access to it
SUMMARY_TEMPLATE_NOT_FOUND404No completed summary exists for the requested template_key

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Call ID (cll-*)

Body

contentstringrequired

Full replacement markdown content. Max 100,000 characters.

template_keyenum<string>

Required only when the call has more than one completed summary template.

MARKDOWN_CLASSICMARKDOWN_SHORT_CALL

Responses

200Updated summary
dataobject
5 fields
idstring

Call ID this summary belongs to

contentstring | null

Markdown summary content

versioninteger<int64>

Optimistic-lock version. Increments on every successful update.

updated_atstring<date-time> | null
updated_byobject | null
2 fields
idstring
namestring | null
400
401
404
429