BizKitHub
DocsAPI ReferencePost/bff/post/locales
getPostAdmin BFF

/bff/post/locales

Returns the per-locale state matrix for the post: primary locale, every organisation locale (existence / staleness / last-edited timestamp), and any orphan locales that have a content__post_locale row but are no longer enabled for the organisation. Powers the locale strip in the admin post detail.

PostgetBffPostLocales

Parameters

1 query

Query parameters

· 1
idstringRequired

Post external ID.

ExampleaBcDeFgH12345678

Response schema

1 status code documented

200Success
postIdstringRequired

Echoed external ID of the post.

primaryLocalestringRequired

Organisation default locale (ISO 639-1). Every stale check compares translations against this.

localesobject[]Required
Each array item:
localestringRequired

ISO 639-1 code.

isPrimarybooleanRequired

True for the organisation default locale — always emitted first.

inOrganisationbooleanRequired

True when the locale is enabled via cas__organisation_locale. False = orphan translation.

existsbooleanRequired

True when a content__post_locale row exists.

hasContentbooleanRequired

True when the locale row has non-empty title AND content (after trim).

isStalebooleanRequired

True when the non-primary translation was generated from an older source-locale history entry than the current one. Always false for the primary locale.

lastEditedAtDate | string | string | number | nullRequired
One of 2:
Variant 1
Date | string | string | number

Most recent content__post_history row for this locale.

One of 4:
Variant 1
Date

Most recent content__post_history row for this locale.

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

Response example

application/json
{
  "postId": "example_postId",
  "primaryLocale": "example_primaryLocale",
  "locales": [
    {
      "locale": "example_locale",
      "isPrimary": false,
      "inOrganisation": false,
      "exists": false,
      "hasContent": false,
      "isStale": false
    }
  ]
}

Request example

GET /bff/post/locales

get
curl -X GET "https://api.bizkithub.com/bff/post/locales?id=aBcDeFgH12345678" \
  -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