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

# POST /v1/loop-jobs

`POST /v1/loop-jobs`

## Request body

- object
  - `model_file_id` string, required
  - `loop_count` number, required
  - `cool_down_seconds` number, required
  - `sweep_mode` 'base' | 'top_tap' | 'slow_tap_ramp' | 'dynamic' | 'targeted' | 'bounded'
  - `sweep_z` number
  - `tap_offset` number
  - `ramp_start_f` number
  - `ramp_end_f` number
  - `ramp_segments` number
  - `only_calibrate_first_loop` boolean
  - `auto_level_each_loop` boolean — Run auto-leveling before each loop (default: false - only level on first loop)
  - `enable_bed_flex` boolean — Enable bed flex motion before sweep (CoreXY printers - P1P, P1S, X1C)
  - `flex_z_height` number — Z height for flex motion in mm (default: 0.5)
  - `flex_cycles` integer — Number of flex up/down cycles (default: 3)
  - `organizationId` string — Organization ID (optional, defaults to user's primary organization)

## Response `200`

Default Response

- object
  - `id` string

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `404` — Default Response
- `500` — Default Response
- `503` — Default Response
- `504` — 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)