SMsmartling
Job Batches V2

Create batch

Changed on

Creates a new batch for the given Job with a list of file names to be uploaded. File names can be added while files are being uploaded to the batch, but only before the batch starts executing. The batch executes as soon as the last file from the initial list or subsequently added files is uploaded or cancelled.

post/job-batches-api/v2/projects/{projectId}/batches

Request

  • Base URL
    https://api.smartling.com
  • Auth
    HTTP bearer

Path parameters

projectIdstring required

Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

Example:84c012a33

A unique project identifier. This can be found in the Smartling Dashboard under Account Settings > API.

Request body

authorizeboolean required

If set to true, the job will be authorized when the upload and attach processes are completed for all files in the batch.

translationJobUidstring required

Translation job unique identifier — 12 lowercase alphanumeric characters.

fileUrisstring[] required

A list of File URI's to be uploaded later. Must be a non-empty array with unique values. Each file URI must not be blank and must not exceed 512 characters.

rushJobboolean nullable

If set to true, rush delivery will be requested when the job is authorized. Only takes effect when authorize is set to true. If omitted or set to null, no rush delivery preference is applied.

Example request

{
  "translationJobUid": "j45v1uvsi3tx",
  "localeWorkflows": [
    {
      "targetLocaleId": "fr-FR",
      "workflowUid": "5449a8595ae4",
      "contentAssignments": [
        {
          "workflowStepUid": "7564fc097a85",
          "userUids": [
            "7f3b8d2a9c6e"
          ]
        }
      ],
      "translationJobWorkflowStepDueDates": [
        {
          "workflowStepUid": "7564fc097a85",
          "dueDate": "2026-01-15T10:00:00Z"
        }
      ]
    }
  ]
}

Response

OK

Changes