# Delete a note

Canonical page: https://docs.ovok.com/slim-apis/notifications/delete-a-note

| Method | Path |
| --- | --- |
| `DELETE` | `/v1/slim/notifications/notes/:noteId` |

[Authentication](/authentication) · [Access policies](/access-policies)

Deletes a note. A note is a practitioner's comment on a notification, stored as a FHIR `Communication` whose `basedOn` points at the alert. The alert itself is never changed.

**Auth:** Bearer token. The caller must be a practitioner, an admin, a super admin, or hold the "System Owner" access policy. The access policy must grant `Patient:read` (admins and super admins skip this check). Only the note's author can delete it.
**Scope:** The caller's project (from the token). An alert or note from another project, of another kind, or that does not exist answers the same 404.

## Request [#request]

### Path parameters [#path-parameters]

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `noteId` | `string (uuid)` | Yes | The note's `id`. |

No query parameters or body.

## Behaviour [#behaviour]

- The note is marked `entered-in-error`, not erased, so the clinical record and its history survive.
- A deleted note leaves every list and every `noteCount`.
- Only the practitioner who wrote the note can delete it. Another caller gets 403.
- Deleting a note that is already deleted answers 404.
- A note on an out-of-bed or alarm notification also needs you to still be able to read that notification. A note on a medical episode or a raw alert does not call Signals, so deleting works while Signals is down.
- If the note changed while your delete was in flight, the route answers 409. Reload the note and try again.
- Answers 204 with no body.

## Example [#example]

```bash
curl -X DELETE 'https://api.sandbox.ovok.com/v1/slim/notifications/notes/3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"
```

## Successful response [#successful-response]

`204` — The note was deleted. No body.

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| [`401`](/errors/unauthenticated) | Bearer token is missing, invalid or expired. |
| [`403`](/errors/forbidden) | You lack `Patient:read` or are not the note's author. |
| [`404`](/errors/not-found) | The note does not exist or was already deleted, or it belongs to another project. |
| [`409`](/errors/conflict) | The note changed while this delete was in flight. Reload it and try again. |
| [`422`](/errors/validation-failed) | `noteId` is not a UUID. |
