---
title: "POST /v1/internal/start-print-attempts/{id}/command-result"
method: POST
path: "/v1/internal/start-print-attempts/{id}/command-result"
---

# POST /v1/internal/start-print-attempts/{id}/command-result

`POST /v1/internal/start-print-attempts/{id}/command-result`

## Path parameters

- `id` string, uuid, required

## Request body

- union
  - object
    - `kind` 'acknowledged', required
    - `code` string
    - `message` string
  - object
    - `kind` 'ambiguous', required
    - `code` 'MQTT_TIMEOUT' | 'COMMAND_RESULT_UNKNOWN', required
    - `message` string, required
  - object
    - `kind` 'rejected', required
    - `code` string, required
    - `message` string, required

## Response `200`

Default Response

- union
  - object
    - `kind` 'recorded', required
    - `attemptState` 'acknowledged' | 'ambiguous', required
  - object
    - `kind` 'confirmed', required
  - object
    - `kind` 'retry_scheduled', required
    - `jobId` integer, required
    - `retryCount` integer, required
    - `nextEligibleAt` string, date-time, required
  - object
    - `kind` 'job_terminal', required
    - `jobId` integer, required
    - `status` 'ERROR' | 'FAILED' | 'CANCELLED', required
    - `lockRetained` unknown, required

## Other responses

- `default` — Unexpected error response

## Changes

- **2026-09-03** `a8bfa8f6865b` — 2 warning
  - added the new `CANCELLED` enum value to the `oneOf[subschema #4]/status` response property for the response status `200`
  - added the new `FAILED` enum value to the `oneOf[subschema #4]/status` response property for the response status `200`
- **2026-09-02** `68b1a29f92cd` — 3 breaking, 4 info
  - added the new required request property `kind`
  - removed `subschema #1, subschema #2, subschema #3` from the request body `oneOf` list
  - the request's body type changed from no type to `object`
  - added the new optional request property `code`
  - …3 more
- **2026-08-29** `daa5509d053e` — 1 breaking, 1 info
  - the `oneOf[subschema #2]/code` request property type changed from no type to `string`
  - added the new `COMMAND_RESULT_UNKNOWN` enum value to the request property `oneOf[subschema #2]/code`
- **2026-08-26** `d3534718dbba` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/internal/start-print-attempts/:id/command-result/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/6f1a23af942d?raw)