Supprimer une section de collection

Supprime une section et orpheline ses éléments (section_id remis à null) au lieu de les supprimer.

Réponse exemple

{
  "id": "sec_9Lp4rT1xYwQ7",
  "object": "collection_section",
  "deleted": true
}

DELETE/v1/collections/{id}/sectionsSupprime une section et détache ses éléments.

Supprime une section de la collection {id}. Comportement notable et non destructif pour le contenu : les éléments rattachés à la section ne sont pas supprimés mais orphelinés, c'est-à-dire que leur section_id est remis à null (ils restent dans la collection, sans section). La section visée est désignée par le champ id du corps de la requête. La collection est vérifiée comme vôtre avant l'opération.

Authentification

Cette requête exige une clé API valide disposant du scope transfers:write. Transmettez la clé via Authorization: Bearer cof_live_.... Une clé sans ce scope reçoit 403 scope_missing.

Corps de la requête

Champ	Type	Requis	Description
id	string	Oui	Identifiant de la section à supprimer. Absent ou non-chaîne : `400 validation_error`.

Réponse

Renvoie un accusé de suppression : id (l'identifiant de la section supprimée), object valant "collection_section" et deleted valant true. Le statut HTTP de succès est 200.

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

Erreurs

Code	Quand	Résolution
400 validation_error	`id` de section absent ou non-chaîne.	Transmettez `{ "id": "sec_..." }` dans le corps.
401 missing_api_key	En-tête Authorization absent.	Ajoutez `Authorization: Bearer cof_live_...`.
401 invalid_api_key	Clé invalide ou préfixe non reconnu.	Vérifiez la clé.
403 scope_missing	La clé n'a pas le scope `transfers:write`.	Émettez une clé incluant `transfers:write`.
404 not_found	Collection inexistante/hors de votre espace, ou section introuvable dans cette collection.	Vérifiez les identifiants de collection et de section.
429 rate_limited	Quota de requêtes par minute dépassé.	Patientez selon l'en-tête `Retry-After`.
500 internal_error	Erreur de suppression en base.	Réessayez ; conservez le `request_id`.

Voir aussi

GET /v1/collections/{id}/sections — lister les sections
POST /v1/collections/{id}/sections — créer une section
PATCH /v1/collections/{id}/sections — modifier une section