> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dokument löschen

> Ein von dir hochgeladenes Dokument zusammen mit den extrahierten Ergebnissen löschen

Lösche ein Dokument, das du mit [Dokument hochladen](https://docs.anivahealth.com/de/api/documents/upload-document.md) hochgeladen
hast. Nutze das, wenn du eine Datei ins falsche Profil hochgeladen hast. Aniva löscht die Datei und
alle daraus extrahierten Werte. Die Werte verschwinden auch aus der Aniva-App des Mitglieds.

Erfordert den Scope `documents_upload` für die Profilgruppe, unter der das Dokument hochgeladen wurde.

Aniva sendet anschließend den [Webhook](https://docs.anivahealth.com/de/concepts/webhooks.md) `document.deleted` an die Endpunkte,
die das letzte Ergebnis-Event des Dokuments erhalten haben. Eine Löschung kann nicht rückgängig
gemacht werden.

## Anfrage

### Pfadparameter

**id** `string` *required*

Dokument-ID (UUID) aus der Upload-Antwort.

## Antwort

Bei Erfolg gibt die API `200 OK` zurück.

**id** `string` *required*

Das gelöschte Dokument.

**deleted** `boolean` *required*

Immer `true`.

## Fehlerantworten

| Status | Beschreibung |
| - | - |
| `400` | Ungültiges ID-Format. |
| `403` | Deinem API-Schlüssel fehlt der Scope `documents_upload`. |
| `404` | Kein Dokument, das unter einer deiner Profilgruppen hochgeladen wurde, hat diese ID. |
| `500` | Interner Serverfehler. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/documents/f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "f8a1b2c3-d4e5-4f6a-8b8c-9d0e1f2a3b4c",
  "deleted": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.