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

# POST /v1/printer-events/batch

`POST /v1/printer-events/batch`

## Request body

- object
  - `batchId` string
  - `idempotencyKey` string
  - `printerId` string, required
  - `events` object[], required
    - `eventId` string
    - `idempotencyKey` string
    - `type` string, required
    - `timestamp` number, required
    - `seqn` number
    - `data` object, required
    - `persistedId` string
  - `delta` object
  - `timestamp` number
  - `maxSeqn` number
  - `hostId` string

## Response `200`

Default Response

- object
  - `success` boolean, required
  - `processed` number, required
  - `failed` number
  - `jobId` string

## Other responses

- `400` — Default Response
- `404` — Default Response
- `500` — Default Response
- `503` — Default Response

## Changes

- **2026-07-26** `750c8a136307` — 6 info
  - added the new optional request property `batchId`
  - added the new optional request property `events/items/eventId`
  - added the new optional request property `events/items/idempotencyKey`
  - added the new optional request property `idempotencyKey`
  - …2 more

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/printer-events/batch/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/535140848bc4?raw)