---
title: "POST /v1/jobs/{jobId}/subtasks"
method: POST
path: "/v1/jobs/{jobId}/subtasks"
tags: ["Sub-Tasks"]
---

# POST /v1/jobs/{jobId}/subtasks

`POST /v1/jobs/{jobId}/subtasks`

Create sub-tasks for a print job

## Path parameters

- `jobId` string, required

## Request body

- object
  - `tasks` object[], required
    - `task_type` 'empty_bed_detection' | 'temperature_check' | 'gcode_command' | 'ai_detection' | 'capture_frame' | 'cooldown_check' | 'printer_ready_check' | 'file_upload' | 'start_print' | 'bed_clear' | 'wait_for_temperature' | 'reheat' | 'webhook_signal' | 'mqtt_signal' | 'prime_nozzle' | 'verify_bed_clear' | 'post_complete_bed_detection' | 'bed_occupancy_verification', required
    - `phase` 'pre' | 'in_flight' | 'post', required
    - `is_required` boolean
    - `max_retries` number
    - `timeout_ms` number
    - `parameters` object
    - `schedule_interval_ms` number

## Response `200`

Default Response

- object
  - `subtasks` object[]
    - `id` string
    - `task_type` string
    - `phase` string
    - `status` string

---

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