Créer une section dans une collection

Crée une nouvelle section dans une collection, avec auto-positionnement en fin de liste.

Requête exemple

{
  "name": "Documents juridiques",
  "position": 20,
  "is_visible": true,
  "description": "Statuts, pactes et baux"
}

Réponse exemple

{
  "id": "sec_9Lp4rT1xYwQ7",
  "name": "Documents juridiques",
  "position": 20,
  "created_at": "2026-06-05T10:42:18.553Z",
  "is_visible": true,
  "description": "Statuts, pactes et baux"
}

POST/v1/collections/{id}/sectionsCrée une section dans la collection désignée.

Crée une nouvelle section dans la collection {id}. Comportement notable : si position n'est pas fournie, la section est auto-positionnée en fin de liste (la dernière position connue + 10, ou 0 si la collection ne contient encore aucune section). La collection est vérifiée comme vôtre avant insertion. En cas de succès, la réponse est renvoyée avec le statut HTTP 201.

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
name	string	Oui	Nom de la section. Espaces de bord supprimés ; une valeur vide après nettoyage déclenche `400 validation_error`.
description	string \| null	Non	Description de la section. Valeur non-chaîne ignorée (stockée `null`).
position	number	Non	Position d'affichage (arrondie à l'entier inférieur). Si absente, auto-calculée en fin de liste (dernière position + 10).
is_visible	boolean	Non	Visibilité de la section. Par défaut `true` si non fournie ou non booléenne.

Réponse

Renvoie la section créée avec son id généré, ainsi que name, description, position (effective, auto-calculée si non transmise), is_visible et created_at. Le statut HTTP de succès est 201.

Champ	Type	Description
id	string	Identifiant unique de la section créée.
name	string	Nom enregistré.
description	string \| null	Description enregistrée.
position	number	Position effective (auto-calculée si omise).
is_visible	boolean	Visibilité enregistrée.
created_at	string (ISO 8601)	Date de création.

Erreurs

Code	Quand	Résolution
400 validation_error	`name` absent ou vide après suppression des espaces.	Fournissez un `name` non vide.
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 ou hors de votre espace de travail.	Vérifiez l'`id` de la collection.
429 rate_limited	Quota de requêtes par minute dépassé.	Patientez selon l'en-tête `Retry-After`.
500 internal_error	Erreur d'insertion en base.	Réessayez ; conservez le `request_id`.

Voir aussi

GET /v1/collections/{id}/sections — lister les sections
PATCH /v1/collections/{id}/sections — modifier une section
DELETE /v1/collections/{id}/sections — supprimer une section