Allo

Update conversation note

Updates a note's content. Only the note's author can edit it.

PATCH/v2/api/conversations/notes/{id}

Behavior

Replaces the note's content. Only the note's author can edit it — updating someone else's note returns 403 with code NOT_NOTE_AUTHOR.

Mentions are re-parsed from the new content — see the mentions guide.

Errors

StatusCodeWhen
400EMPTY_NOTE_CONTENTcontent is missing or blank
400NOTE_CONTENT_TOO_LONGcontent exceeds 4,000 characters
403NOT_NOTE_AUTHORThe API key's user is not the note's author
404NOTE_NOT_FOUNDNo note with this ID

Authorization

Authorizationstring · headerrequired

Api-Key ak_live_…

Path parameters

idstringrequired

Note ID (not-*)

Body

contentstringrequired

Note text (max 4000 characters). Mention teammates inline with @[Name](usr-...), or @[all](all) to notify the whole team.

Responses

200Updated note
dataobject
8 fields
idstring

Note ID (not-*)

contentstring

Note text, with mentions inline as @[Name](usr-...).

contact_numberstring

The contact's phone number (E.164).

allo_numberstring | null

The Allo line the conversation belongs to (E.164).

userobject

Author of a note or comment.

2 fields
idstring
namestring | null
mentionsobject[]
3 fields
user_idstring
namestring | null
deletedboolean

true if the mentioned user has since been removed from the team.

created_atstring<date-time>
updated_atstring<date-time>
400
401
403
404
429