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

# Supprimer un document

> L'endpoint API files peut être utilisé pour supprimer un document téléchargé de Paradigm.

## Prérequis

* Une **clé API Paradigm** : si vous n'en avez pas, rendez-vous sur votre profil Paradigm (`/settings/api-key` dans votre instance) et générez une nouvelle clé API.
* L'**ID du document désiré à supprimer** : Vous pouvez utiliser la méthode de listage pour obtenir la liste des documents téléchargés et pouvoir connaître l'ID du document que vous voulez supprimer.

## Méthodes d'utilisation

Il existe plusieurs façons d'appeler l'endpoint :

1. Avec le **package python `requests`**
2. Via une **requête curl** : pour des tests rapides ou une première utilisation

## Package python `requests`

Vous pouvez envoyer directement une requête à l'endpoint API via le package `requests`.

```python theme={null}
import requests
import os

# Récupérer la clé API et l'URL de base depuis l'environnement
api_key = os.getenv("PARADIGM_API_KEY")
base_url = os.getenv("PARADIGM_BASE_URL", "https://paradigm.lighton.ai/api/v2")
# ID du fichier à supprimer
file_id = 1

response = requests.request(
    method="DELETE",
    url=f"{base_url}/files/{file_id}",
    headers={
        'Authorization': f"Bearer {api_key}"
    }
)

print(response.json())
```

Vous obtiendriez alors une réponse JSON sous forme de dictionnaire :

```json theme={null}
{
    "id": 1,
    "deleted": true
}
```

## Requête cURL

Si vous préférez envoyer une requête à Paradigm avec une simple commande cURL, voici un exemple :

```shell theme={null}
curl --request DELETE \
  --url $PARADIGM_BASE_URL/files/1 \
  --header "Authorization: Bearer $PARADIGM_API_KEY"
```