---
title: "Request Stop for one exact active print attempt"
method: POST
path: "/v1/print-jobs/{id}/stop"
tags: ["Print Jobs"]
---

# Request Stop for one exact active print attempt

`POST /v1/print-jobs/{id}/stop`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/print-jobs/{id}/stop`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/printhiv3d/apis/hive-api-documentation/docs/v1/print-jobs/:id/stop/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- object
  - `receiptId` string, uuid, required
  - `startAttemptId` string, uuid, required

## Response `200`

Default Response

- object
  - `id` string, uuid, required
  - `job_id` integer, required
  - `printer_id` string, uuid, required
  - `start_attempt_id` string, uuid, required
  - `claim_generation` string, uuid, required
  - `expected_device_task_id` string, required
  - `command_outcome` 'unknown' | 'acknowledged' | 'rejected' | 'not_delivered', required
  - `confirmation` 'pending' | 'confirmed' | 'unconfirmed' | 'rejected' | 'already_ended' | 'unsupported', required
  - `requested_at` string, date-time, required
  - `deadline_at` string, date-time, required
  - `confirmed_at` string, date-time, nullable, required
  - `abort_acknowledged` boolean
  - `reason` 'printer_family_unsupported' | 'job_already_ended', nullable, required
  - `printerFamily` string, nullable, required
  - `jobStatus` string, required
  - `message` string, nullable, required

## Other responses

- `403`: Default Response
- `404`: Default Response
- `409`: Default Response
- `503`: Default Response

## Changes

- **2026-11-10** `09f2403145b5`: 3 info
  - api operation id `stopPrintJob` was added
  - the endpoint scheme security `apiKeyAuth` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-11-10** `78d74bd36d6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/print-jobs/:id/stop/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/35a7515c29d5?raw)