---
title: "Bulk update job statuses"
method: POST
path: "/v1/workflows/bulk-status-update"
tags: ["Workflows"]
---

# Bulk update job statuses

`POST /v1/workflows/bulk-status-update`

## Request

- Base URL: `https://api.workwing.io`
- URL: `https://api.workwing.io/v1/workflows/bulk-status-update`
- Auth: HTTP bearer

Update the status of multiple jobs at once. Up to 100 jobs per request.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `job_ids` string[], required
  - `status` 'T_PENDING' | 'T_SCHEDULED' | 'T_ASSIGNED' | 'T_IN_PROGRESS' | 'T_ON_HOLD' | 'T_INCOMPLETE' | 'T_REBOOK' | 'T_COMPLETED' | 'T_CANCELLED' | 'T_FAILED', required
  - `status_notes` string

## Response `200`

Default Response

- object
  - `data` object, required
    - `updated` integer, required
    - `failed` integer, required
    - `results` object[], required: One entry per requested job, in request order
      - `job_id` string, uuid, required
      - `success` boolean, required
      - `new_status` string: Present when the update succeeded
      - `error` string: Present when the update failed
  - `meta` object, required
    - `request_id` string, required
    - `timestamp` string, date-time, required

---

[API](https://skmtc.dev/workwing/apis/workwing-api.md) · [All operations](https://skmtc.dev/workwing/apis/workwing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/workwing/apis/workwing-api/revisions/54bb14368a35?raw)