Requête exemple
Réponse exemple
Supprime définitivement un transfert et l'ensemble de ses données associées. La suppression est scopée au workspace : l'identifiant fourni doit appartenir au workspace du token utilisé, sinon l'API répond 404 not_found (un transfert d'un autre workspace est traité comme inexistant, jamais comme interdit). L'opération est irréversible : une fois supprimé, le transfert n'est plus accessible et les liens de partage publics associés cessent de fonctionner. La réponse confirme la suppression avec l'identifiant ciblé.
Authentification
Cet endpoint exige un token (clé API cof_live_…/cof_test_…, clé restreinte cof_rk_… ou token MCP cof_mcp_…) portant le scope transfers:write. Le scope joker * ou transfers:* satisfait également l'exigence. Le token est passé dans l'en-tête Authorization: Bearer …. Les appels en session dashboard (cookie Supabase) sont acceptés et disposent du scope *.
Paramètres de chemin
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| id | string (path) | Oui | Identifiant du transfert à supprimer. Doit appartenir au workspace du token, sinon 404 not_found. |
Cet endpoint n'attend aucun corps de requête : le wrapper ignore le body sur les requêtes DELETE.
Réponse
En cas de succès (200), l'API renvoie un objet de confirmation minimal : id reprend l'identifiant du transfert supprimé, object vaut toujours "transfer", et deleted vaut true. La réponse inclut les en-têtes standard X-Request-Id, X-Coffrify-Api-Version et les en-têtes de quota X-RateLimit-*.
| Champ | Type | Description |
|---|---|---|
| id | string | Identifiant du transfert supprimé (identique au paramètre de chemin). |
| object | string | Toujours "transfer". |
| deleted | boolean | Toujours true lorsque la suppression a réussi. |
Erreurs
| Code HTTP | code | Quand | Comment résoudre |
|---|---|---|---|
| 401 | missing_api_key | Aucun en-tête Authorization et aucune session valide. | Ajouter Authorization: Bearer cof_live_…. |
| 401 | invalid_api_key | Préfixe de clé non reconnu ou clé introuvable. | Vérifier la clé ou en générer une nouvelle sur app.coffrify.com/developer. |
| 401 | revoked_api_key / expired_api_key | Clé révoquée, inactive ou expirée. | Régénérer une clé API active. |
| 403 | scope_missing | Le token ne porte pas le scope transfers:write. | Émettre un token avec le scope transfers:write (ou transfers:*). |
| 403 | ip_not_allowed | IP appelante hors de l'allowlist de la clé. | Appeler depuis une IP autorisée ou ajuster l'allowlist de la clé. |
| 404 | not_found | Aucun transfert avec cet id dans le workspace du token. | Vérifier l'identifiant et que le transfert appartient bien au workspace. |
| 429 | rate_limited | Quota par minute (classe write) dépassé. | Respecter l'en-tête Retry-After puis réessayer. |
| 500 | internal_error | Erreur base de données ou interne. | Réessayer ; si persistant, contacter le support avec le request_id. |
Voir aussi
GET/v1/transfers/{id}Récupère le détail d'un transfert et la liste de ses fichiers avant suppression.GET/v1/transfersListe les transferts du workspace pour identifier ceux à supprimer.POST/v1/transfers/{id}/extendProlonge l'expiration d'un transfert plutôt que de le supprimer.