Help Center API Reference

Create an API reference version

Creates an empty API reference version in a help center. Then import a spec into it (POST /v2/help_center/api_specs/{specId}/import), review the draft and publish it.

POST

/v2/help_center/api_specs

curl --request POST \
  --url https://do.featurebase.app/v2/help_center/api_specs \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "helpCenterId": "ox6qrqprmsuqaunj",
  "name": "Acme API",
  "sourceType": "api",
  "versionLabel": "v2",
  "versionSlug": "v2"
}
'

{
  "apiSlug": "default",
  "createdAt": "2026-10-01T12:00:00.000Z",
  "draftRevision": 8,
  "hasDraft": true,
  "helpCenterId": "ox6qrqprmsuqaunj",
  "id": "66f7d0c1a2b3c4d5e6f70812",
  "isDefault": true,
  "lastSync": {
    "code": "<string>",
    "createdAt": "2026-10-01T12:00:00.000Z",
    "error": "<string>",
    "finishedAt": "2026-10-01T12:00:00.000Z",
    "revision": 8,
    "status": "draft",
    "syncId": "0f7c3a1e-8d1b-4a53-9a51-3f7a1c9e2b4d"
  },
  "liveOperationCount": 42,
  "liveRevision": 7,
  "name": "Acme API",
  "object": "help_center_api_spec",
  "source": {
    "autoSync": false,
    "lastError": "<string>",
    "lastFetchedAt": "2026-10-01T12:00:00.000Z",
    "type": "api",
    "url": "https://api.acme.com/openapi.json"
  },
  "status": "active",
  "updatedAt": "2026-10-01T12:00:00.000Z",
  "versionLabel": "v2",
  "versionSlug": "v2",
  "visibleBy": [
    "everyone"
  ]
}

The first version of a help center becomes the default. versionSlug must be unique in the help center (lower-case letters, digits and dashes).

Plan limits: the API reference needs the Growth plan or higher; more than 2 active versions need the Professional plan or higher.

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Example: 2026-08-19.orbit

Body

helpCenterIdstring

The help center. Defaults to the active help center of your organization.

Required string length: 1 - 16

Pattern: ^[a-zA-Z0-9]+$

Example: ox6qrqprmsuqaunj

namestringrequired

Name of the API reference.

Required string length: 1 - 128

Example: Acme API

sourceTypeenum<string>

api (pushed from CI with the sync endpoint) or upload (default). The first spec comes from the import or sync endpoint.

Available options: upload, api

Example: api

versionLabelstringrequired

Label of this version in the version picker.

Required string length: 1 - 64

Example: v2

versionSlugstringrequired

URL slug of this version (lower case). It cannot change after the first publish.

Required string length: 1 - 32

Example: v2

Response

Created

apiSlugstringrequired

The API this version belongs to.

Example: default

createdAtstring | nullrequired

When the version was created.

Example: 2026-10-01T12:00:00.000Z

draftRevisionnumber | nullrequired

The revision that waits for review. Null = no draft.

Example: 8

hasDraftbooleanrequired

A draft waits for review (see the draft endpoint).

Example: true

helpCenterIdstringrequired

The help center.

Example: ox6qrqprmsuqaunj

idstringrequired

The API reference version id (specId).

Example: 66f7d0c1a2b3c4d5e6f70812

isDefaultbooleanrequired

The default version (no version prefix in URLs).

Example: true

lastSyncobject | nullrequired

The newest CI push or API import of this version.

Show child attributes

liveOperationCountnumber | nullrequired

Endpoints in the live revision (list only; null otherwise).

Example: 42

liveRevisionnumber | nullrequired

The published revision. Null = never published.

Example: 7

namestringrequired

Name of the API reference.

Example: Acme API

objectenum<string>required

Object type identifier

Available options: help_center_api_spec

Example: help_center_api_spec

sourceobjectrequired

Where the spec comes from.

Show child attributes

statusenum<string>required

Version status.

Available options: active, deprecated, archived

Example: active

updatedAtstring | nullrequired

When the version was last changed.

Example: 2026-10-01T12:00:00.000Z

versionLabelstringrequired

Label in the version picker.

Example: v2

versionSlugstringrequired

URL slug of the version.

Example: v2

visibleBystring[]required

Who can see this version.

Still need help? Ask the team