---
search:
  tags:
    - Operations
    - PATCH
seo:
  description: >-
    Change a highlight's note. Reference for the PATCH
    /v1/highlights/{highlightId} endpoint in the Teak API.
sidebar:
  label: Change a highlight's note
  badge: PATCH
title: Change a highlight's note
type: openapi-operation
---
`PATCH /v1/highlights/{highlightId}`

**Request body** (`application/json`, required)

- `note` (string | null, required) — The new note, at most 2,000 characters, or null to clear it.

Request body example:

```json
{
  "note": "string"
}
```

**Responses**

- `200` — Highlight updated
- `400` — INVALID\_INPUT: no note, or a note too long
- `404` — Highlight not found
- `429` — RATE\_LIMITED

Response example, 200:

```json
{
  "id": "string",
  "cardId": "string",
  "quote": "string",
  "note": "string",
  "anchored": true,
  "source": "reader",
  "createdAt": 0,
  "updatedAt": 0
}
```