Skip to main content
PATCH
/
v2
/
api
/
conversations
/
items
/
{id}
/
summary
Update call summary
curl --request PATCH \
  --url https://api.withallo.com/v2/api/conversations/items/{id}/summary \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "# Summary\n\nCustomer asked about pricing for the Pro plan and confirmed a follow-up call next Tuesday."
}
'
{
  "data": {
    "id": "cll-abc123",
    "content": "# Summary\n\nCustomer asked about pricing for the Pro plan and confirmed a follow-up call next Tuesday.",
    "version": 4,
    "updated_at": "2026-05-12T14:32:11",
    "updated_by": {
      "id": "usr-abc123",
      "name": "Alex Kim"
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

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

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