BizKitHub
DocsAPI ReferencePost/bff/post/history-restore
postPostAdmin BFF

/bff/post/history-restore

Overwrites the live content__post_locale row for the post + locale of the source revision with that revision's title and content body, then writes a new history entry ("Restored from version X") authored by the caller.

The restore is itself a versioned act — the new history entry it produces can be the target of a later restore, so an "undo my undo" is just another /history-restore call. Coalescing is disabled for restore writes so they always land as distinct landmarks in the commit log even if the same author was editing seconds before.

PostpostBffPostHistory-restore

Parameters

JSON body

Request body

application/json
idstringRequired

History version handle to restore (16 chars).

ExamplevErSiOnHaNdLe123

Response schema

1 status code documented

200Success
success"true"Required
postIdstringRequired

External id of the post that was restored.

localestringRequired

Locale code that was restored.

restoredFromVersionIdstringRequired

External id of the source revision (the snapshot put back live).

newVersionIdstringRequired

External id of the new history entry created by the restore. Use this to roll the restore back via another /history-restore call.

Response example

application/json
{
  "success": true,
  "postId": "example_postId",
  "locale": "example_locale",
  "restoredFromVersionId": "example_restoredFromVersionId",
  "newVersionId": "example_newVersionId"
}

Request example

POST /bff/post/history-restore

post
curl -X POST "https://api.bizkithub.com/bff/post/history-restore" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "id": "vErSiOnHaNdLe123"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key