SapanBaseDevelopers

Create a draft article

Creates a DRAFT from Markdown. In a developer-docs knowledge base this creates a draft PAGE. Scope: content:write.

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

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
  • titlestringrequired
  • markdownstringrequired
  • categoryIdstring
  • knowledgeBaseIdstring
  • docVersionIdstring

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

  • excerptstring
  • tagsarray of string

Responses

  • articleIdstring
  • versionIdstring
  • statusstringdraft
  • adminUrlstring
  • ignoredTagsarray of string

    Supplied tags dropped because no matching tag (by id or name) exists in the company catalogue. Tags are never created.

Errors