SapanBaseDevelopers

Create a category

Creates an UNPUBLISHED category. In a developer-docs knowledge base this creates a SECTION. Scope: content:write.

POSThttps://api.helpbento.com/v1/categories

Authentication

AuthorizationstringheaderBearer <token>required

An API key, e.g. hb_live_… (live) or hb_test_… (test).

Header parameters

1 param
  • Idempotency-Keystringlength: 0…255

    Optional idempotency key (1–255 chars). Repeating a mutating request with the same key within 24h replays the original response instead of re-executing it; a concurrent in-flight request with the same key returns 409. Use a unique key (e.g. a UUID) per logical operation so network retries are safe.

Request body

application/jsonrequired
  • namestringrequired
  • knowledgeBaseIdstring
  • docVersionIdstring

    Developer-docs only: the version this section belongs to (from GET /v1/doc-versions). Defaults to the KB default version; inherited from the parent section when parentId is set.

  • descriptionstring
  • parentIdstring

Responses

  • categoryIdstring
  • manageUrlstring
Errors