---
title: "Create batch"
method: POST
path: "/job-batches-api/v2/projects/{projectId}/batches"
tags: ["Job Batches V2"]
---

# Create batch

`POST /job-batches-api/v2/projects/{projectId}/batches`

## Request

- Base URL: `https://api.smartling.com`
- URL: `https://api.smartling.com/job-batches-api/v2/projects/{projectId}/batches`
- Auth: HTTP bearer

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.

## Path parameters

- `projectId` string, required: Unique identifier of a Smartling project — 9 lowercase alphanumeric characters.

## Request body

- CreateBatchRequestV2: The payload to use when creating a job batch.
  - `authorize` boolean, required: If set to true, the job will be authorized when the upload and attach processes are completed for all files in the batch.
  - `translationJobUid` string, required: Translation job unique identifier — 12 lowercase alphanumeric characters.
  - `fileUris` string[], 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.
  - `localeWorkflows` WorkflowDTO[]: Optional array of workflow configurations for target locales
    - `targetLocaleId` string, required: Locale identifier. Either a 2-letter language code (`en`) or a language-region pair (`en-US`). The language part is always lowercase; the region part is always uppercase.
    - `workflowUid` string: Workflow unique identifier — 12 lowercase alphanumeric characters.
    - `contentAssignments` ContentAssignmentDTO[]: Optional content assignments for specific workflow steps
      - `workflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.
      - `userUids` UserUid[], required: Array of user UIDs to assign to this workflow step. Must contain exactly 1 user UID (minimum 1, maximum 1).
    - `translationJobWorkflowStepDueDates` TranslationJobWorkflowStepDueDateDTO[]: Optional due dates for specific workflow steps. **Constraint**: This field can only be specified when the batch `authorize` parameter is set to `true`.
      - `workflowStepUid` string, required: Workflow step unique identifier — 12 lowercase alphanumeric characters.
      - `dueDate` string, date-time, required: ISO 8601 UTC timestamp.
  - `rushJob` boolean, 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.

## Response `200`

OK

- CreateBatchResponse: Info about created batch.
  - `response` object, required
    - `code` 'SUCCESS', required: Indicates whether the response was successful or what error has occurred.
    - `data` object
      - `batchUid` string: The UID of the created batch.

## Other responses

- `400`: Validation error
- `401`: Provided credentials are not valid.
- `404`: provided translationJobUid is not found in the TMS
- `500`: Unexpected error

## Changes

- **2026-10-17** `2cd7a8215799`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/changes/job-batches-api/v2/projects/:projectId/batches/post.md)

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) - [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/revisions/e63066e7f5e9?raw)