BizKitHub
DocsAPI ReferencePost/bff/post/history-list
getPostAdmin BFF

/bff/post/history-list

Returns the commit log for a post: every revision recorded in content__post_history, newest first. Each item carries the version handle, timestamp, locale, author, optional commit message, snapshot title and the byte size of the stored content blob (so the UI can render "1.2 MB" without fetching the body). The actual HTML body lives in blob storage and is only loaded by /history-detail. Pass ?locale=cs to scope to one language.

PostgetBffPostHistory-list

Parameters

2 query

Query parameters

· 2
idstringRequired

Post external ID.

ExampleaBcDeFgH12345678
localestringOptional

Optional locale filter (e.g. "cs", "en"). When omitted, the response mixes all languages. Each entry always carries its own locale field regardless.

Examplecs

Response schema

1 status code documented

200Success
postIdstringRequired

Echo of the post external id the history belongs to.

localestring | nullRequired
One of 2:
Variant 1
string

Echo of the locale filter, or null when none was applied.

Variant 2
null
itemsobject[]Required
Each array item:
idstringRequired

History version handle (16 chars). Pass to /history-detail.

insertedDateDate | string | string | numberRequired

When this revision was recorded.

One of 4:
Variant 1
Date

When this revision was recorded.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
localestringRequired

Locale code of this revision (e.g. "cs", "en").

titlestringRequired

Snapshot of the post title at this revision.

commitMessagestring | nullRequired
One of 2:
Variant 1
string

Optional human commit message; null for auto-versions.

Variant 2
null
kind"manual" | "auto" | "auto-translate-initial" | "auto-translate-refresh" | "restore"Required

Coarse classification of what caused the revision, so the UI can render a badge without parsing the commit message.

contentSizenumberRequired

Byte size of the content blob.

authorobjectRequired
idstring | nullRequired
One of 2:
Variant 1
string

cuRefNo of the author contact.

Variant 2
null
namestringRequired

Display name of the author.

Response example

application/json
{
  "postId": "example_postId",
  "items": [
    {
      "id": "example_id",
      "locale": "example_locale",
      "title": "example_title",
      "contentSize": 0,
      "author": {
        "name": "example_name"
      }
    }
  ]
}

Request example

GET /bff/post/history-list

get
curl -X GET "https://api.bizkithub.com/bff/post/history-list?id=aBcDeFgH12345678&locale=cs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key