API Reference

Launch AI or Crowdin translation for a quiz

post
https://api.web2wave.com/api/quizzes//translate

Queue a translation of the quiz into one or more target languages.

  • method=ai (default) — uses the platform LLM. Returns 202 Accepted with an async=true payload by default; pass wait=true to block until the job finishes (long requests, only recommended for small language sets).
  • method=crowdin — uploads the quiz to the project's Crowdin configuration (must be enabled via PUT /project/translation-connections).

If a translation is already running for this quiz the request is a no-op and returns the in-progress status. Each completed language creates or updates a sibling Quiz row (see GET /quizzes/{quizId}/translations).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
Body Params
languages
array of strings
required
length ≥ 1

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.

languages*
string
enum
Defaults to ai

Translation provider. crowdin requires Crowdin connection enabled.

Allowed:
string | null

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

boolean
Defaults to false

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

boolean
Defaults to false

AI-only. ALMOST ALWAYS leave false (default). When false the API dispatches the job to the project's async queue and returns 202 immediately — clients poll status_url (TranslationStatus) for progress. Set true ONLY when you intentionally want the HTTP request to block for the full translation duration (small language sets, debugging). Blocking can take minutes per language and will tie up a PHP worker the whole time.

Responses

422

Validation error / Crowdin not configured

Updated 8 days ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 8 days ago