---
title: "Update Annotation"
method: PATCH
path: "/data/v1/annotations/{ANNOTATION_ID}"
tags: ["Annotations"]
---

# Update Annotation

`PATCH /data/v1/annotations/{ANNOTATION_ID}`

Updates an existing annotation.

## Path parameters

- `ANNOTATION_ID` string, uuid, required

## Request body

- AnnotationInput
  - `note` string, required — The annotation note content
  - `date` integer, required — Datetime when the annotation applies (Unix timestamp)
  - `sub_property_id` string — Customer-defined sub-property identifier

## Response `200`

OK

- AnnotationResponse
  - `data` Annotation, required
    - `id` string, uuid, required — Unique identifier for the annotation
    - `note` string, required — The annotation note content
    - `date` string, date-time, required — Datetime when the annotation applies
    - `sub_property_id` string, nullable — Customer-defined sub-property identifier

## Changes

- **2025-08-05** `ba7ebfd893a1` — 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738` — 1 info
  - the endpoint scheme security `accessToken` was added to the API
- **2025-05-12** `fe7095c6cd41` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/annotations/:ANNOTATION_ID/patch.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) · [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/ba7ebfd893a1/schema)