---
title: "POST /v1/printer-events"
method: POST
path: "/v1/printer-events"
---

# POST /v1/printer-events

`POST /v1/printer-events`

## Request body

- object
  - `eventId` string
  - `idempotencyKey` string
  - `eventType` 'status' | 'message' | 'rawMessage' | 'client:connect' | 'client:disconnect' | 'client:error' | 'printer:dataUpdate' | 'printer:deltaUpdate' | 'printer:statusUpdate' | 'printer:amsUpdate' | 'printer:filamentStateChanged' | 'printer:error' | 'job:update' | 'job:start' | 'job:pause' | 'job:offlineRecovery' | 'job:unpause' | 'job:finish' | 'heartbeat' | 'file:uploadStart' | 'file:uploadComplete' | 'file:uploadError' | 'detection:failure' | 'detection:warning' | 'detection:bedEmpty' | 'detection:complete', required
  - `data` object, required
  - `seqn` number
  - `hostId` string
  - `timestamp` number

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `jobId` unknown
  - `message` string

## Other responses

- `400` — Default Response
- `404` — 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)