---
title: "Update print job"
method: PATCH
path: "/v1/print-jobs/{id}"
tags: ["Print Jobs"]
---

# Update print job

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

Update a queued print job's printer assignment and/or print options. Only QUEUED jobs can be updated.

## Path parameters

- `id` string, required

## Query parameters

- `organizationId` string

## Request body

- object
  - `printer_id` unknown
  - `print_options` object — Print options including AMS mapping
    - `enable_ams` boolean
    - `enable_bed_leveling` boolean
    - `start_immediately` boolean
    - `set_printer_ready` boolean — Deprecated compatibility alias for start_immediately
    - `enable_filament_backup` boolean
    - `auto_assign` boolean
    - `ams_mapping` integer[]
    - `ams_mapping2` union[]
      - union
        - integer
        - object
          - `ams_id` integer, required
          - `slot_id` integer, required
    - `ams_mapping_info` object[]
      - `sourceColor` string
      - `targetColor` string
      - `filamentType` string
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `200`

Job updated successfully

- object — Job updated successfully
  - `success` boolean
  - `job` object — Updated print job

## Other responses

- `400` — Bad request - job not in QUEUED status
- `403` — Forbidden - not authorized to update this job
- `404` — Job not found
- `500` — Internal server error

## Changes

- **2026-08-11** `6ac11cc265be` — 1 breaking, 3 info
  - the `print_options/ams_mapping2/items/` request property type/format changed from `integer`/`` to ``/``
  - added the new optional request property `print_options/set_printer_ready`
  - added the new optional request property `print_options/start_immediately`
  - added `subschema #1, subschema #2` to the `print_options/ams_mapping2/items/` request property `anyOf` list
- **2026-08-06** `8be36ce70a6b` — 1 warning
  - removed the request property `print_options/start_immediately`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/print-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)