---
title: "PATCH /v1/batch-jobs/{id}"
method: PATCH
path: "/v1/batch-jobs/{id}"
---

# PATCH /v1/batch-jobs/{id}

`PATCH /v1/batch-jobs/{id}`

## Path parameters

- `id` string, required

## Request body

- object
  - `organizationId` string, required
  - `name` string
  - `description` string, nullable
  - `deadline` string, nullable
  - `dedicated_printer_ids` string[], nullable
  - `max_concurrent_printers` integer, nullable
  - `update_items` object[]
    - `batch_item_id` string, required
    - `target_count` number, required
  - `add_items` object[]
    - `model_file_id` string, required
    - `part_name` string
    - `target_count` number, required
  - `remove_item_ids` string[]

## Response `200`

Default Response

## Other responses

- `default` — Unexpected error response

## Changes

> 24 revisions in range; 15 could not be searched.

- **2026-07-26** `750c8a136307` — 1 info
  - added the new optional request property `max_concurrent_printers`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/batch-jobs/:id/patch.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/daa5509d053e/schema)