/api/v1/post/history

Returns the commit log for a post: every revision recorded in content__post_history, newest first.

A post with multi-locale content (e.g. cs + en + de) has independent revision streams per language. Pass locale=cs to scope to one language, omit to get all languages mixed; either way each item exposes its own locale field.

Designed so external consumers (e.g. ChatSPC) can present a version timeline without operating their own database. Each entry carries the version handle, timestamp, locale, snapshot title, optional commit message and the byte size of the stored content blob. The HTML body itself is fetched on demand via /api/v1/post/history/version.

Endpoint Info

Base URLapi.bizkithub.com

AuthBearer Token

Methods1

Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

3 query parameters

apiKeystringrequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

idstringrequired

Post public id (content__post.external_id).

localestring

Communication locale code used to filter content.

Supported locales: cs, en, fr, it, pl, de, sk, sv, es, zh, ja, uk, da.

Length: 2 - 2

Example Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/post/history?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&id=6IU2SWgP76FO2UXw&locale=cs", {
  method: "GET",
  headers: {
    "Content-Type": "application/json"
  }
});

const data = await response.json();
console.log(data);

get

Example Response

200Success

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

cURL

Command line example

curl -X GET "https://api.bizkithub.com/api/v1/post/history?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE&id=6IU2SWgP76FO2UXw&locale=cs" \
  -H "Content-Type: application/json"

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key

Back to API Documentation API Reference