Skip to main content
PATCH
Update person note
Required scope: NOTES_WRITE

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

Authorizations

Authorization
string
header
required

Path Parameters

person_id
string
required

Person ID (per-*) — the id field from the People API.

Example:

"per-abc123"

note_id
string
required

Note ID (cno-*)

Example:

"cno-abc123"

Body

application/json
content
string
required

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

Example:

"Escalate to @[Jane Doe](usr-abc123) tomorrow"

Response

Updated note

data
object