Crear una sección

Crea una sección de nivel superior en la navegación de tu centro de ayuda.

POST /v1/sections

Token Bearer ámbito 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": []
}

Sección creada

Cuerpo

obligatorio application/json

name string · min length: 1 obligatorio

Nombre de la sección.

slug string · min length: 1

Slug de URL; se deriva del nombre cuando se omite.

iconData any

Icono que se muestra junto a la sección en la navegación del centro de ayuda.

Cuerpo

Respuestas