Crear una colección

Crea una colección, la agrupación que contiene artículos relacionados dentro de una sección.

POST /v1/collections

Token Bearer ámbito content:write

curl 'https://api.ferndesk.com/v1/collections' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "Authentication",
  "subtitle": "API key and token flows",
  "sectionId": "sect_01JXYA4T1JNT",
  "parentCollectionId": "col_01JXYA6ABN52"
}'

{
  "id": "col_01JXYA6ABN52",
  "helpdeskId": "help_01JXYA7B3T7G",
  "sectionId": "sect_01JXYA4T1JNT",
  "parentCollectionId": "parent_collection_01JXY9AZK4KV",
  "title": "Authentication",
  "subtitle": "API key and token flows",
  "shortId": "C0L123",
  "createdAt": "2026-01-15T18:25:43.511Z",
  "updatedAt": "2026-01-15T18:25:43.511Z",
  "translations": []
}

Colección creada

Cuerpo

obligatorio application/json

title string · min length: 1 obligatorio

Título de la colección.

subtitle string | null

Línea complementaria que se muestra debajo del título.

sectionId string · min length: 1 obligatorio

Sección en la que se creará la colección.

parentCollectionId string | null

Colección bajo la que se anidará esta.

Cuerpo

Respuestas