Supprimer une section d'un coffre

Supprime une section et détache ses éléments en les rendant orphelins plutôt que de les supprimer.

Requête exemple

{
  "section_id": "sec_a71b9d02"
}

Réponse exemple

{
  "id": "sec_a71b9d02",
  "object": "coffre_section",
  "deleted": true
}

DELETE/v1/coffres/{id}/sectionsSupprime une section du coffre {id}, ciblée par section_id dans le corps.

Supprime une section du coffre {id}. La section cible est désignée par section_id dans le corps de la requête. Comportement notable : les éléments (items) rattachés à la section ne sont pas supprimés. Ils sont d'abord détachés en passant leur section_id à null, devenant ainsi des éléments orphelins du coffre, avant que la section elle-même ne soit effacée. La suppression est restreinte au couple coffre/workspace de la clé API.

Authentification

Cet endpoint exige une clé API valide portant le scope transfers:write. Un jeton sans ce scope reçoit une erreur 403 scope_missing.

Corps de la requête

Champ	Type	Requis	Description
section_id	string	Oui	Identifiant de la section à supprimer. Absent : `400 validation_error`. Inconnu pour ce coffre/workspace : `404 not_found`.

Réponse

Renvoie 200 OK avec un accusé de suppression : id (l'identifiant de la section supprimée), object valant "coffre_section", et deleted à true.

Champ	Type	Description
id	string	Identifiant de la section supprimée.
object	string	Toujours `"coffre_section"`.
deleted	boolean	Toujours `true` en cas de succès.

Erreurs

Code	Quand	Résolution
400 validation_error	Identifiant de coffre manquant, ou `section_id` absent du corps.	Transmettez un `section_id` dans le corps JSON et un `{id}` de coffre valide dans l'URL.
401 invalid_api_key	Clé API absente, mal formée ou non reconnue.	Fournissez une clé valide dans l'en-tête `Authorization`.
403 scope_missing	Le jeton ne porte pas le scope `transfers:write`.	Émettez une clé incluant `transfers:write`.
404 not_found	La section n'existe pas pour ce coffre/workspace.	Vérifiez `section_id` et l'identifiant du coffre.
429 rate_limited	Quota de requêtes par minute dépassé.	Respectez l'en-tête `Retry-After` puis réessayez.
500 internal_error	Échec de la suppression en base.	Réessayez ; en cas de persistance, contactez le support avec le `request_id`.

Voir aussi

GET /v1/coffres/{id}/sections : vérifier les sections restantes après suppression.
POST /v1/coffres/{id}/sections : recréer une section.
PATCH /v1/coffres/{id}/sections : masquer une section au lieu de la supprimer.