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