---
title: "POST /v1/printers/{id}/next-job"
method: POST
path: "/v1/printers/{id}/next-job"
---

# POST /v1/printers/{id}/next-job

`POST /v1/printers/{id}/next-job`

## Path parameters

- `id` string, required

## Query parameters

- `dry_run` 'true' | 'false'

## Headers

- `x-hive-retry-handoff-version` string
- `x-hive-claim-generation-version` string

## Response `200`

Default Response

- object
  - `job` object, nullable
    - `id` number
    - `name` string
    - `organization_id` string
    - `printer_id` string
    - `material` string
    - `progress` number
    - `status` string
    - `claim_generation` string, uuid
    - `ftp_probe_token` string, nullable
    - `retry_handoff_expires_at` string, date-time, nullable
    - `printer` object, nullable
      - `id` string
      - `name` string
      - `serial_number` string
    - `print_options` object, nullable
      - `enable_ams` boolean
      - `ams_mapping` number[]
      - `enable_bed_leveling` boolean
      - `force_download` boolean
      - `timelapse` boolean
      - `task_layer_inspect` boolean
    - `model_file` object, nullable
      - `id` string
      - `filename` string
      - `file_path` string
      - `file_type` string
      - `file_size` number
      - `created_at` string
      - `metadata` object
  - `match` object, nullable
    - `score` number
    - `reasons` string[]

## Other responses

- `400` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response
- `503` — Default Response

## Changes

- **2026-08-27** `2bfa47974b56` — 1 info
  - added the non-success response with the status `403`
- **2026-08-06** `8be36ce70a6b` — 1 warning
  - removed the optional property `job/print_options/start_immediately` from the response with the `200` status
- **2026-08-02** `4a0fbdd6e87d` — 3 info
  - added the new optional `header` request parameter `x-hive-claim-generation-version`
  - added the new optional `header` request parameter `x-hive-retry-handoff-version`
  - added the optional property `job/claim_generation` to the response with the `200` status
- **2026-07-31** `df096aa5ed08` — 2 info
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`
- **2026-07-26** `750c8a136307` — 3 info
  - added the non-success response with the status `409`
  - added the optional property `job/ftp_probe_token` to the response with the `200` status
  - added the optional property `job/retry_handoff_expires_at` to the response with the `200` status

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