Help Center API Reference

Retrieve an API reference version

Returns one API reference version: status, visibility, default flag, source (type and URL; secret-looking query values are masked), live revision, whether a draft waits for review, and the last CI sync or import.

GET

/v2/help_center/api_specs/{specId}

curl --request GET \
  --url https://do.featurebase.app/v2/help_center/api_specs/{specId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit'

{
  "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"
  ]
}

Authorizations

Authorizationstringheaderrequired

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

Path Parameters

specIdstringrequired

The API reference version (id from the list).

Example: 66f7d0c1a2b3c4d5e6f70812

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

Response

Success

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