---
title: "Safely cancel a Triggered BOV batch"
method: POST
path: "/v1/organizations/{organizationId}/printer-control/triggered-bov-batches/{batchId}/cancel"
tags: ["Printer Control"]
---

# Safely cancel a Triggered BOV batch

`POST /v1/organizations/{organizationId}/printer-control/triggered-bov-batches/{batchId}/cancel`

Stops untouched inspections immediately while already-started inspections settle and restore safely.

## Path parameters

- `organizationId` string, uuid, required
- `batchId` string, uuid, required

## Response `200`

Default Response

- object
  - `batch` union, required
    - object
      - `id` string, uuid, required
      - `organizationId` string, uuid, required
      - `action` 'triggered_bov', required
      - `actorUserId` string, uuid, required
      - `idempotencyKey` string, required
      - `targetFingerprint` string, required
      - `status` 'active' | 'cancelling' | 'cancelled' | 'completed' | 'completed_with_cancelled_items' | 'completed_with_conflicts' | 'failed', required
      - `stage` string, required
      - `attempt` integer, required
      - `revision` integer, required
      - `targetCount` integer, required
      - `successCount` integer, required
      - `conflictCount` integer, required
      - `cancelledCount` integer, required
      - `cancellationRequestedAt` string, required
      - `cancellationRequestedByUserId` string, uuid, required
      - `startedAt` string, required
      - `completedAt` string, required
      - `updatedAt` string, required
      - `items` object[], required
        - `id` string, uuid, required
        - `ordinal` integer, required
        - `printerId` string, uuid, required
        - `expectedCompletedJobId` integer, required
        - `targetSnapshot` object, required
          - `printerName` string, required
          - `completedJobName` string, required
          - `completedJobStatus` 'COMPLETED', required
        - `status` 'pending' | 'queued' | 'throttled' | 'reused' | 'accepted' | 'executing' | 'released' | 'already_converged' | 'occupied' | 'inconclusive' | 'unsupported' | 'stale' | 'infrastructure_failure' | 'cancelled', required
        - `reasonCode` string, required
        - `evidenceRef` object, required
        - `executionRef` string, uuid, required
        - `watchRef` string, uuid, required
        - `attempt` integer, required
        - `startedAt` string, required
        - `completedAt` string, required
        - `updatedAt` string, required
      - `channel` 'web', required
      - `consent` object, required
        - `kind` 'triggered_bov_batch_confirmation', required
        - `confirmedAt` string, required
        - `zMotionAcknowledged` true, required
    - object
      - `id` string, uuid, required
      - `organizationId` string, uuid, required
      - `action` 'triggered_bov', required
      - `actorUserId` string, uuid, required
      - `idempotencyKey` string, required
      - `targetFingerprint` string, required
      - `status` 'active' | 'cancelling' | 'cancelled' | 'completed' | 'completed_with_cancelled_items' | 'completed_with_conflicts' | 'failed', required
      - `stage` string, required
      - `attempt` integer, required
      - `revision` integer, required
      - `targetCount` integer, required
      - `successCount` integer, required
      - `conflictCount` integer, required
      - `cancelledCount` integer, required
      - `cancellationRequestedAt` string, required
      - `cancellationRequestedByUserId` string, uuid, required
      - `startedAt` string, required
      - `completedAt` string, required
      - `updatedAt` string, required
      - `items` object[], required
        - `id` string, uuid, required
        - `ordinal` integer, required
        - `printerId` string, uuid, required
        - `expectedCompletedJobId` integer, required
        - `targetSnapshot` object, required
          - `printerName` string, required
          - `completedJobName` string, required
          - `completedJobStatus` 'COMPLETED', required
        - `status` 'pending' | 'queued' | 'throttled' | 'reused' | 'accepted' | 'executing' | 'released' | 'already_converged' | 'occupied' | 'inconclusive' | 'unsupported' | 'stale' | 'infrastructure_failure' | 'cancelled', required
        - `reasonCode` string, required
        - `evidenceRef` object, required
        - `executionRef` string, uuid, required
        - `watchRef` string, uuid, required
        - `attempt` integer, required
        - `startedAt` string, required
        - `completedAt` string, required
        - `updatedAt` string, required
      - `channel` 'hex', required
      - `consent` object, required
        - `kind` 'eve_operation_proposal', required
        - `proposalId` string, required
        - `proposalVersion` integer, required
        - `decisionReceiptId` string, required
        - `executionReceiptId` string, required
        - `targetFingerprint` string, required
        - `confirmedAt` string, required
        - `zMotionAcknowledged` true, required
  - `requestId` string, required

## Other responses

- `400` — Default Response
- `401` — 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/535140848bc4/schema)