SapanBaseDevelopers

Update an article draft

Edits land on the draft; the live article is unchanged until publish. markdown is required. Scope: content:write.

PATCHhttps://api.helpbento.com/v1/articles/{id}

Authentication

AuthorizationstringheaderBearer <token>required

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

Path parameters

1 param
  • idstringrequired

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
  • markdownstringrequired
  • titlestring
  • excerptstring
  • tagsarray of string
  • categoryIdstring

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