Sign in

v1

latestOpenAPI 3.0.32026-07-248519153.1 KB
Translations

Launch AI or Crowdin translation for a paywall

post/paywalls/{paywallId}/translate

Path parameters

paywallIdinteger required

Request body

languagesstring[] required

Target languages. Accepts both platform codes (es, pt, fr) and Crowdin codes (es-ES, pt-PT, fr). Codes are normalised to Crowdin form server-side. See GET /project/translation-languages.

method'ai' | 'crowdin'

Translation provider. crowdin requires Crowdin connection enabled.

custom_promptstring nullable

AI-only. Overrides the project default for this single run.

save_promptboolean

AI-only. When true and custom_prompt is supplied, persist it on the project as the new default for subsequent translations.

Example request

{
  "languages": [
    "es",
    "fr",
    "de",
    "pt-BR"
  ]
}

Response

Translation queued

successinteger
asyncboolean
methodstring
statusstring
status_urlstring uri

GET this URL to poll progress (see TranslationStatus schema).

languagesstring[]
messagestring

Example response

{
  "success": 1,
  "async": true,
  "method": "ai",
  "status": "queued",
  "message": "AI translation queued — poll status_url for progress."
}