Requête exemple
Réponse exemple
DELETE/v1/storageSupprime un fichier identifié par file_id, après contrôle d'appartenance au workspace.Cet endpoint supprime un fichier précis de votre stockage. L'identifiant du fichier est transmis dans le corps de la requête (et non dans l'URL). Avant toute suppression, le serveur vérifie que le fichier existe puis que le transfert parent appartient bien à votre workspace : une suppression croisée entre workspaces est donc impossible. L'opération est définitive et n'est pas idempotente côté API : un second appel sur un fichier déjà supprimé renverra une erreur not_found.
Authentification
L'appel exige une clé API valide portant le scope transfers:write. La vérification de propriété s'appuie sur le workspace de la clé : le transfert parent du fichier doit vous appartenir, sinon la suppression est refusée.
Corps de la requête
| Champ | Type | Requis | Description |
|---|---|---|---|
| file_id | string | Oui | Identifiant du fichier à supprimer. Doit appartenir à un transfert de votre workspace. |
Réponse
En cas de succès, la réponse renvoie un unique champ booléen deleted à true, confirmant que l'enregistrement du fichier a été retiré.
| Champ | Type | Description |
|---|---|---|
| deleted | boolean | Vaut true lorsque le fichier a été supprimé avec succès. |
Erreurs
| Code | Quand | Résolution |
|---|---|---|
| validation_error (400) | file_id absent ou non textuel dans le corps. | Fournissez un file_id de type chaîne dans le corps JSON. |
| missing_api_key (401) | Aucune clé API fournie. | Ajoutez un en-tête Authorization: Bearer <clé>. |
| scope_missing (403) | La clé ne porte pas le scope transfers:write. | Accordez le scope transfers:write à la clé. |
| forbidden (403) | Le fichier existe mais son transfert n'appartient pas à votre workspace. | Vérifiez que le file_id cible bien un fichier de votre workspace. |
| not_found (404) | Aucun fichier ne correspond au file_id fourni. | Vérifiez l'identifiant ; il a pu déjà être supprimé. |
| rate_limited (429) | Quota par minute du workspace dépassé sur les endpoints d'écriture. | Patientez selon l'en-tête Retry-After, puis réessayez. |
| internal_error (500) | Échec de la suppression côté base de données. | Réessayez ; si l'erreur persiste, contactez le support avec le X-Request-Id. |
Voir aussi
- GET /v1/storage — lister les fichiers et récupérer leur file_id.
- GET /v1/transfers/{id} — inspecter le transfert parent d'un fichier.
- DELETE /v1/transfers/{id} — supprimer un transfert complet.