Translate Site

Starts a background job that translates a site's content from one locale to another.

The call returns as soon as the job is accepted, and the response contains only the job's ID. Pass that ID to Get Translation Job Status to track the job.

The job reads the site's content as it goes, rather than working from a snapshot taken when it started. Content edited while the job is running may or may not be included, depending on whether the job has already reached it.

Translated fields are marked as ready to publish as the job completes them.

Several jobs can run against the same site at the same time. Each job selects its fields independently, according to its own filterByStatus, at the moment it reads them. Two jobs started close together can both select the same field and translate it twice. Wait for a job to reach COMPLETED or FAILED before starting another one over the same content.

The translation engine is selected automatically based on the site's editor. You can't choose it in the request, and the job doesn't report which engine ran.