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
| Status | Code | When |
|---|
400 | EMPTY_NOTE_CONTENT | content is missing or blank |
400 | NOTE_CONTENT_TOO_LONG | content exceeds 4,000 characters |
403 | NOT_NOTE_AUTHOR | The API key's user is not the note's author |
404 | NOTE_NOT_FOUND | No 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
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
mentionsobject[]
3 fields
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