---
title: "PATCH /2023-10-12/batch-update-job"
method: PATCH
path: "/2023-10-12/batch-update-job"
---

# PATCH /2023-10-12/batch-update-job

`PATCH /2023-10-12/batch-update-job`

Updates multiple jobs in a single request. This is a batch version of the `UpdateJob` API.

The result of updating each job is reported individually in the response. Because the batch request can result in a combination of successful and unsuccessful actions, you should check for batch errors even when the call returns an HTTP status code of 200.

When you change the status of a job to `ARCHIVED`, the job can't be scheduled or archived.

An archived job and its steps and tasks are deleted after 120 days. The job can't be recovered.

## Headers

- `X-Amz-Client-Token` string

## Request body

- object
  - `jobs` BatchUpdateJobItem[], required — The list of jobs to update. You can specify up to 100 jobs per request.
    - `farmId` string, required — The farm ID of the job to update.
    - `queueId` string, required — The queue ID of the job to update.
    - `jobId` string, required — The job ID of the job to update.
    - `targetTaskRunStatus` 'READY' | 'FAILED' | 'SUCCEEDED' | 'CANCELED' | 'SUSPENDED' | 'PENDING' — The task status to update the job's tasks to.
    - `priority` integer — The job priority to update.
    - `maxFailedTasksCount` integer — The number of task failures before the job stops running and is marked as <code>FAILED</code>.
    - `maxRetriesPerTask` integer — The maximum number of retries per failed tasks.
    - `lifecycleStatus` 'ARCHIVED' — <p>The status of a job in its lifecycle. When you change the status of the job to <code>ARCHIVED</code>, the job can't be scheduled or archived.</p> <important> <p>An archived job and its steps and tasks are deleted after 120 days. The job can't be recovered.</p> </important>
    - `maxWorkerCount` integer — The maximum number of worker hosts that can concurrently process a job.
    - `name` string — The name of the job to update.
    - `description` string, password — The description of the job to update.

## Response `200`

Success

- BatchUpdateJobResponse
  - `errors` BatchUpdateJobError[], required — A list of errors for jobs that could not be updated.
    - `farmId` string, required — The farm ID of the job that could not be updated.
    - `queueId` string, required — The queue ID of the job that could not be updated.
    - `jobId` string, required — The job ID of the job that could not be updated.
    - `code` 'ConflictException' | 'InternalServerErrorException' | 'ResourceNotFoundException' | 'ValidationException' | 'AccessDeniedException' | 'ThrottlingException', required — The error code.
    - `message` string, required — The error message.

## Other responses

- `480` — AccessDeniedException
- `481` — InternalServerErrorException
- `482` — ThrottlingException
- `483` — ValidationException

---

[API](https://skmtc.net/aws/apis/deadline.md) · [All operations](https://skmtc.net/aws/apis/deadline/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/deadline/versions/259a7ebfefa8/schema)