Skip to content

post/translate ​

Translates post text and title.

Overview ​

Use this endpoint to translate post content in preview mode or from stored post data.

Authentication ​

Authentication behavior is partially confirmed. See Authentication.

Permissions ​

Authentication is required.

Endpoint ​

post/translate ​

Purpose ​

Translates text and returns translated text or HTML.

Method and path ​

POST /post/translate

Headers ​

HeaderRequiredDescription
X-Api-Key or X_API_KEYyesAPI key.
Content-Typeyesapplication/json.

Request body ​

Preview mode:

FieldTypeRequiredDescription
intentstringyesMust be preview.
postData.post_textstringyesText to translate.
postData.titlestringnoOptional title.
postData.langstringnoSource language code.

Normal mode:

FieldTypeRequiredDescription
projectIdintegeryesProject identifier.
uuidstringyesPost UUID.

Example request ​

bash
curl -X POST "$SIGNAL_API_BASE_URL/post/translate" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "preview",
    "postData": {
      "post_text": "Example text to translate",
      "lang": "it"
    }
  }'

Example response ​

html
<p>Translated text output</p>

Notes ​

  • Target language is controlled by the API translation configuration.

Doc rev.1.12.3 2026.05.08