Run translation pass

MCPrun_translation_pass

WRITE$0.00001 / call

Features

Start a REAL translation catch-up run for one or more languages: the same batch the panel's 'Translate now' starts, with pages that are behind translated before pages that are missing. Answers with the job id per language as soon as the runs are open — the pages themselves land over the following minutes and are visible in Translations. It NEVER discards existing translations (that is the owner's 'Re-translate everything'). Every call translates that site chrome for every language asked about — INCLUDING the ones it reports as skipped — so a project whose pages are all current is repaired by an ordinary call.

Input3

Authorizationheaderrequired

Your API key, for the REST call. Sent from your browser straight to the API — never to Docsbook, never stored.

workspace_idstringrequired

Numeric workspace id — OR the project as the user names it: 'owner/repo', the repo name alone, the site's display name, its docs URL or custom domain. Text is resolved server-side; an ambiguous name returns the candidates instead of guessing, so pass what the user said rather than calling list_workspaces first.

languagesstring[]

ISO codes to bring level (default: every language switched on for this project)

forceboolean

Run even for a language coverage says is already level with the source (default false)

Output1

……

The job id started per language — pages land over the following minutes.

Limitations

Languages already level with the source are skipped unless force=true, a language with a live run is left alone, and at most 3 languages are started per call.
🔴 THIS IS ALSO THE CALL FOR 'the pages are translated but the MENU / breadcrumbs / header buttons / tabs / suggested questions are still in English'.
Do NOT reach for force=true to fix English chrome: force re-runs every page in the repo and costs real money to rewrite a few dozen short strings.
REQUIRES PRO or higher.

Example input

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_translation_pass",
    "arguments": {
      "workspace_id": "<workspace_id>"
    }
  }
}

Example output

{
  "…": "<…>"
}

更新于 Sep 24, 2026