Skip to main content
PATCH
Update call summary
Required scope: CONVERSATIONS_WRITE
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.

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. If the call has no completed summary matching the supplied template_key, the request returns 404 SUMMARY_TEMPLATE_NOT_FOUND.

Error codes

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Call ID (cll-*)

Example:

"cll-abc123"

Body

application/json
content
string
required

Full replacement markdown content. Max 100,000 characters.

Maximum string length: 100000
template_key
enum<string> | null

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

Available options:
MARKDOWN_CLASSIC,
MARKDOWN_SHORT_CALL

Response

Updated summary

data
object