---
title: "Supprimer un document"
description: "Supprime un document envoyé par l’API, et son fichier.\n\n- Refusé (`400`) pour les documents générés par Puncto ou ajoutés dans l’application, les justificatifs de variables de paie (supprimés avec leur variable) et les fichiers liés à une DPAE.\n- Un document envoyé sans `foreignErpId` par une clé d’API révoquée depuis ne peut plus être supprimé."
---

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

Path: API Puncto › Documents

`DELETE /public/v1/documents/{documentId}`

Supprime un document envoyé par l’API, et son fichier.

- Refusé (`400`) pour les documents générés par Puncto ou ajoutés dans l’application, les justificatifs de variables de paie (supprimés avec leur variable) et les fichiers liés à une DPAE.
- Un document envoyé sans `foreignErpId` par une clé d’API révoquée depuis ne peut plus être supprimé.

## Authentication

- `bearerAuth`, http, header `Authorization`

## Path parameters

- `documentId` (`deleteDocument.path.documentId`; string, required) — Identifiant Puncto du document.
  - example `"cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"`

## Code samples

### cURL

```bash
curl --request DELETE \
  --url https://api.puncto.fr/public/v1/documents/cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY \
  --header 'Authorization: Bearer <token>'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/documents/cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/documents/cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)
```

## Responses

### 204

Document supprimé

### 400

Document que l’API n’a pas envoyé

#### Example

```json
{
  "error": "Seuls les documents envoyés par l’API peuvent être supprimés"
}
```

- `error` (`deleteDocument.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteDocument.response.400.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`deleteDocument.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteDocument.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`deleteDocument.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteDocument.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Document introuvable dans l’entreprise ou non exposé par l’API

#### Example

```json
{
  "error": "Document non trouvé"
}
```

- `error` (`deleteDocument.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`deleteDocument.response.404.errorCode`; string, optional) — Code stable, sur certaines erreurs.


Source: https://docs.puncto.fr/reference/documents/delete/index.md
