---
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
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.net/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/versions/3b06bcb5f808/schema)