Skip to main content
POST
Rerun an existing order to regenerate the translation. This endpoint triggers a new translation process using the current AI models and any updated settings. The original order will be processed again, and the results will replace the previous translation. By default only the selected order is reprocessed. Set triggerFullChain: true to also reset and rerun the order’s connected dependency chain — see Rerunning Connected Order Chains for details.

Authorizations

This endpoint requires API key authentication. Include your API key in the request header:
  • Header name: X-Api-Key
  • Header value: Your API key from the Ollang dashboard
  • Format: X-Api-Key: your-api-key-here
You can obtain your API key from your Ollang dashboard.

Path Parameters

string
required
The unique identifier of the order you want to rerun. The order must be a completed (or stalled) Level 0 order of an eligible type — cc, subtitle, aiDubbing, or document.

Request Body

The request body is optional. You can send an empty object {} to rerun the order with default settings.
boolean
default:"false"
When true, the order’s connected dependency chain is reset and reprocessed in dependency order — the deepest dependency regenerates first and the requested order regenerates last using the fresh results. When false or omitted, only the selected order is rerun and existing dependency results are reused. See Rerunning Connected Order Chains.

Response

boolean
required
Indicates whether the rerun was initiated successfully.
string
required
A message describing the result of the rerun request.
string
The ID of the order being rerun. This is the same as the input orderId.
boolean
true when a full-chain rerun was initiated, false for a standard single-order rerun.
string[]
Every order that was triggered, from the requested order down to its deepest dependency. Contains a single ID for standard reruns.

Full-chain specific errors

Requests with triggerFullChain: true can additionally fail with: All chain validation runs before any order is reset or charged — a rejected request never leaves the chain partially processed.