Créer une section

Crée une section de niveau supérieur dans la navigation de votre centre d’aide.

POST /v1/sections

Jeton Bearer portée content:write

curl 'https://api.ferndesk.com/v1/sections' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Guides",
  "slug": "guides",
  "iconData": {
    "type": "huge",
    "id": "book-01"
  }
}'

{
  "id": "sect_01JXYA4T1JNT",
  "helpdeskId": "help_01JXYA7B3T7G",
  "name": "Guides",
  "iconData": {
    "type": "huge",
    "id": "book-01"
  },
  "isDefault": false,
  "position": 1,
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z",
  "translations": []
}

Section créée

Corps

requis application/json

name string · min length: 1 requis

Nom de la section.

slug string · min length: 1

Slug d’URL ; dérivé du nom lorsqu’il est omis.

iconData any

Icône affichée à côté de la section dans la navigation du centre d’aide.

Corps

Réponses