---
title: "Delete an annotation"
method: POST
path: "/api/annotations.delete"
tags: ["Web Analytics"]
---

# Delete an annotation

`POST /api/annotations.delete`

Deletes an annotation, automatic ones included — a broadcast annotation cannot come back by accident, since its broadcast has already started. Requires the web_analytics write permission.

## Request body

- DeleteAnnotationRequest
  - `workspace_id` string, required
  - `id` string, required

## Response `200`

Annotation deleted. A body rather than a 204, so a delete is never indistinguishable from a proxy swallowing the response.

- DeleteAnnotationResponse
  - `success` boolean

## Other responses

- `400` — Bad request - unparseable body, missing id, or the instance runs in demo mode.
- `401` — Unauthorized - invalid or missing authentication token
- `403` — Forbidden - missing required permission
- `404` — No annotation with that ID in this workspace
- `500` — Internal server error

## Changes

- **2026-08-17** `d26605f2fc47` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pierre-b/apis/notifuse-api/changes/api/annotations.delete/post.md)

---

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