Help Center API Reference

List revisions

Lists the newest revisions of a version (up to 10) that can be published or rolled back to: the live one, the draft and the older ones that are kept, with their change counts.

GET

/v2/help_center/api_specs/{specId}/revisions

List revisions

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

{
  "data": [
    {
      "breaking": true,
      "counts": {
        "added": 123,
        "breaking": 123,
        "changed": 123,
        "removed": 123,
        "unchanged": 123
      },
      "createdAt": "2026-10-01T12:00:00.000Z",
      "isDraft": true,
      "isLive": true,
      "object": "help_center_api_spec_revision",
      "operationCount": 42,
      "publishedAt": "2026-10-01T12:00:00.000Z",
      "revision": 7,
      "status": "ready",
      "trigger": "ci"
    }
  ],
  "nextCursor": null,
  "object": "list"
}

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

dataobject[]required

The newest revisions you can publish or roll back to (up to 10).

Show child attributes

nextCursorstring | nullrequired

Always null.

objectenum<string>required

Available options: list

Example: list

Still need help? Ask the team