---
method: POST
path: /api/media-items/:id/annotations/:annotationId/restore
auth: jwt
area: media-items
---
<!-- source: internal/handlers/annotation_history.go:77 MediaHandler.RestoreDeletedAnnotation -->

# Restore Deleted Annotation

Restores a tombstoned annotation (highlight, note, or bookmark). The kind is
read from the `annotation_type` **query parameter** or, if absent, from a JSON
body `{"annotation_type": "..."}`.

## Example request

```text
POST /api/media-items/550e8400-.../annotations/440e8400-.../restore?annotation_type=highlight
```

## Example response

```json example-response
{
  "restored": true
}
```

## Errors

| Status | Body | When |
| ------ | ---- | ---- |
| 400 | `{"error": "annotation_type must be highlight, note, or bookmark"}` | missing/invalid kind |
| 404 | `{"error": "deleted annotation not found"}` | nothing tombstoned under that id |
| 500 | `{"error": "failed to restore annotation"}` | unexpected server error |
| 503 | `{"error": "annotation service unavailable"}` | service not constructed |