> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Annotation

> Set or remove the note on an annotation.

## Path Parameters

<ParamField path="id" type="string" required>
  The annotation ID. Example: `ann_m2k8v`.
</ParamField>

## Body Parameters

<ParamField body="note" type="string" required>
  The note text. Pass `null` to remove the note.
</ParamField>

## Response

Returns the updated annotation.

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.getmatter.com/public/v1/annotations/ann_m2k8v \
    -H "Authorization: Bearer mat_your_token_here" \
    -H "Content-Type: application/json" \
    -d '{"note": "Core thesis of the essay"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "annotation",
    "id": "ann_m2k8v",
    "item_id": "itm_r9f3a",
    "text": "The way to figure out what to work on is by working.",
    "note": "Core thesis of the essay",
    "created_at": "2026-03-30T18:32:00Z",
    "updated_at": "2026-03-30T20:45:00Z"
  }
  ```
</ResponseExample>