---
title: "POST /v1/batch-jobs"
method: POST
path: "/v1/batch-jobs"
---

# POST /v1/batch-jobs

`POST /v1/batch-jobs`

## Request body

- object
  - `name` string, required
  - `description` string
  - `quantity` number
  - `model_file_id` string
  - `organization_id` string, required
  - `organizationId` string
  - `printer_ids` string[]
  - `task_id` string
  - `make_id` string — Optional make ID to derive required materials
  - `max_concurrent_printers` number — Maximum printers running jobs from this batch simultaneously
  - `deadline` string, date-time — ISO 8601 deadline for production batch completion
  - `dedicated_printer_ids` string[] — Optional dedicated printer pool for this batch
  - `items` object[] — Production batch items (triggers production scheduling mode)
    - `model_file_id` string, required
    - `part_name` string
    - `target_count` number, required
  - `print_options` object
    - `enable_ams` boolean
    - `enable_bed_leveling` boolean
    - `force_download` boolean
    - `timelapse` boolean
    - `task_layer_inspect` boolean
    - `auto_assign` boolean
    - `constraints` object
  - `printer_configs` object

## Response `201`

Default Response

- object
  - `batch_job` object
    - `id` string
    - `name` string
    - `description` string, nullable
    - `total_quantity` number
    - `completed_quantity` number
    - `failed_quantity` number
    - `cancelled_quantity` number
    - `status` string
    - `organization_id` string
    - `created_at` string
    - `updated_at` string
    - `deadline` string, nullable
    - `priority_mode` string
    - `estimated_completion` string, nullable
  - `print_jobs` object[]
    - `id` number
    - `name` string
    - `batch_id` string
    - `printer_id` string, nullable
    - `status` string
  - `batch_items` object[]
    - `id` string
    - `model_file_id` string
    - `part_name` string, nullable
    - `target_count` number
    - `prints_required` number
  - `feasibility` object
    - `feasible` boolean
    - `estimated_completion` string
    - `overproduction_warnings` object[]

## 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)