---
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' | 'bed_occupancy_reveal_calibration', 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

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-25** `6f1a23af942d` — 1 info
  - added the new `bed_occupancy_reveal_calibration` enum value to the request property `tasks/items/task_type`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/jobs/:jobId/subtasks/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.dev/printhiv3d/apis/hive-api-documentation/revisions/6f1a23af942d?raw)