---
title: "Update person note"
method: PATCH
path: "/v2/api/crm/people/{person_id}/notes/{note_id}"
tags: ["Notes"]
---

# Update person note

`PATCH /v2/api/crm/people/{person_id}/notes/{note_id}`

## Request

- Base URL: `https://api.withallo.com`
- URL: `https://api.withallo.com/v2/api/crm/people/{person_id}/notes/{note_id}`
- Auth: API key in header `Authorization`

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

## Path parameters

- `person_id` string, required
- `note_id` string, required

## Request body

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

## Response `200`

Updated note

- object
  - `data` PersonNote
    - `id` string: Note ID (`cno-*`)
    - `person_id` string: Person ID (`per-*`)
    - `content` string: Note text, with mentions inline as `@[Name](usr-...)`.
    - `user` NoteUser: Author of a note or comment.
      - `id` string
      - `name` string, nullable
    - `mentions` NoteMention[]
      - `user_id` string
      - `name` string, nullable
      - `deleted` boolean: `true` if the mentioned user has since been removed from the team.
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `400`: Invalid request parameters
- `401`: Invalid or missing API key
- `403`: API key lacks the required scope or access to the resource
- `404`: Resource not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `46c77103dd14`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/withallo/apis/allo-api/changes/v2/api/crm/people/:person_id/notes/:note_id/patch.md)

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) - [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withallo/apis/allo-api/revisions/46c77103dd14?raw)
