---
title: "POST /v1/printers/{id}/commands"
method: POST
path: "/v1/printers/{id}/commands"
---

# POST /v1/printers/{id}/commands

`POST /v1/printers/{id}/commands`

## Path parameters

- `id` string, required

## Request body

- object
  - `command` 'amsFilamentDrying' | 'cleanPrintError' | 'goHome' | 'loadFilament' | 'pause' | 'refreshPrinterState' | 'resume' | 'stop' | 'stopBuzzer' | 'unloadFilament' | 'updateFan' | 'updateLight' | 'updateSpeed' | 'updateTemp', required
  - `params` object, nullable
    - `light` 'chamber_light' | 'work_light'
    - `isOn` boolean
    - `mode` union
      - 'on' | 'off'
      - 0 | 1
    - `fan` 'part_cooling' | 'part' | 'auxiliary' | 'aux' | 'chamber'
    - `speed` number
    - `part` 'bed' | 'nozzle' | 'chamber'
    - `temperature` number
    - `cleanPrintError` boolean
    - `subtaskId` string
    - `printError` number
    - `extruder` number
    - `amsId` number
    - `filament` string
    - `temp` number
    - `duration` number
    - `rotateTray` boolean
    - `coolingTemp` number
    - `confirm` boolean
  - `organizationId` string

## Response `200`

Default Response

- object
  - `success` boolean
  - `command` string
  - `message` string
  - `response` object

## Other responses

- `400` — Default Response
- `403` — Default Response
- `404` — Default Response
- `502` — 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/versions/3b06bcb5f808/schema)