---
title: "Read a canonical Hex operation proposal"
method: GET
path: "/v1/eve/operations/proposals/{proposalId}"
tags: ["Hex", "Public"]
---

# Read a canonical Hex operation proposal

`GET /v1/eve/operations/proposals/{proposalId}`

Returns one exact proposal version for recovery or cross-device rendering without exposing its normalized execution payload.

## Path parameters

- `proposalId` string, uuid, required

## Query parameters

- `version` integer, required

## Response `200`

Default Response

- object
  - `proposal` object, required
    - `kind` 'eve.operation.proposal', required
    - `contractVersion` 1, required
    - `id` string, uuid, required
    - `version` integer, required
    - `operationType` 'set_printer_ready' | 'release_printers_batch' | 'trigger_bov_batch' | 'create_job' | 'duplicate_job' | 'restart_job' | 'filament_rotation_action' | 'attest_print_outcome', required
    - `title` string, required
    - `summary` string, required
    - `consequence` string, required
    - `risk` 'low' | 'medium' | 'high', required
    - `requiresConfirmation` true, required
    - `target` object
      - `id` string
      - `label` string
      - `type` string
    - `parameters` object[], required
      - `label` string, required
      - `value` string, required
    - `status` 'proposed' | 'approved' | 'cancelled' | 'expired' | 'claimed' | 'executed' | 'failed_before_mutation' | 'indeterminate', required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `500` — Default Response
- `503` — Default Response

## Changes

- **2026-09-04** `2f5f761dfbdc` — 1 warning
  - added the new `attest_print_outcome` enum value to the `proposal/operationType` response property for the response status `200`
- **2026-08-18** `64e0f1284c6f` — 1 warning
  - added the new `trigger_bov_batch` enum value to the `proposal/operationType` response property for the response status `200`
- **2026-08-17** `b987927f2996` — 1 warning
  - added the new `release_printers_batch` enum value to the `proposal/operationType` response property for the response status `200`
- **2026-07-26** `750c8a136307` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/eve/operations/proposals/:proposalId/get.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-service-production.skmtc.workers.dev/v1/apis/printhiv3d/hive-api-documentation/revisions/0869172217d1/schema)