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

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

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

Updates multiple tasks in a single request. This is a batch version of the `UpdateTask` API.

The result of updating each task 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.

## Headers

- `X-Amz-Client-Token` string

## Request body

- object
  - `tasks` BatchUpdateTaskItem[], required — The list of tasks to update. You can specify up to 100 tasks per request.
    - `farmId` string, required — The farm ID of the task to update.
    - `queueId` string, required — The queue ID of the task to update.
    - `jobId` string, required — The job ID of the task to update.
    - `stepId` string, required — The step ID of the task to update.
    - `taskId` string, required — The task ID of the task to update.
    - `targetRunStatus` 'READY' | 'FAILED' | 'SUCCEEDED' | 'CANCELED' | 'SUSPENDED' | 'PENDING', required — The run status with which to start the task.

## Response `200`

Success

- BatchUpdateTaskResponse
  - `errors` BatchUpdateTaskError[], required — A list of errors for tasks that could not be updated.
    - `farmId` string, required — The farm ID of the task that could not be updated.
    - `queueId` string, required — The queue ID of the task that could not be updated.
    - `jobId` string, required — The job ID of the task that could not be updated.
    - `stepId` string, required — The step ID of the task that could not be updated.
    - `taskId` string, required — The task ID of the task 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)