---
title: "POST /v1/print-jobs/create"
method: POST
path: "/v1/print-jobs/create"
---

# POST /v1/print-jobs/create

`POST /v1/print-jobs/create`

## Request body

- object
  - `name` string, required
  - `model_file_id` string, required
  - `organization_id` string
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)
  - `printer_id` string, nullable
  - `task_id` string
  - `make_id` string — Optional make ID to derive required materials
  - `print_options` object
    - `enable_ams` boolean
    - `enable_bed_leveling` boolean
    - `auto_assign` boolean
    - `constraints` object

## Response `201`

Default Response

- object
  - `job` object
  - `eligiblePrinters` object[] — Detailed match results for fully eligible printers
    - `printerId` string
    - `match` object
      - `score` number
      - `reasons` string[]
      - `matched_at` string
      - `printer_id` string
  - `partiallyEligiblePrinters` object[] — Detailed match results for partially eligible printers including missing materials
    - `printerId` string
    - `match` object
      - `score` number
      - `reasons` string[]
      - `matched_at` string
      - `printer_id` string
      - `missing` object[]
        - `index` number
        - `type` string
        - `color` string
        - `explicitMaterialId` string

## Other responses

- `400` — Default Response
- `409` — Default Response
- `500` — 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/revisions/3b06bcb5f808/schema)
