/bff/post/locale-create

Adds a content__post_locale row for a target locale on an existing post. Refuses when the locale is not enabled for the organisation or a translation already exists. Also ensures a canonical core__route row for the new locale so the translation is reachable.

PostpostBffPostLocale-create

Parameters

JSON body

Request body

application/json

postIdstringRequired

Post external ID.

ExampleaBcDeFgH12345678

localestringRequired

Target locale code (ISO 639-1). Must be enabled for the organisation.

Examplescsde

mode"empty" | "copy-from-source" | "ai-translate"Required

empty = placeholder row, editor fills in; copy-from-source = verbatim copy of the primary locale text (no translation model); ai-translate = translated via translatePostTexts() with Markdown/HTML preservation.

Response schema

1 status code documented

200Success

successbooleanRequired

localestringRequired

The locale that was created.

mode"empty" | "copy-from-source" | "ai-translate"Required

routeCreatedbooleanRequired

True when a canonical route was added; false when one already existed.

Response example

application/json

{
  "success": false,
  "locale": "example_locale",
  "routeCreated": false
}

Request example

POST /bff/post/locale-create

post

curl -X POST "https://api.bizkithub.com/bff/post/locale-create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "postId": "aBcDeFgH12345678",
  "locale": "cs"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key