---
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' | 'create_job' | 'duplicate_job' | 'restart_job' | 'filament_rotation_action', 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

---

[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/versions/3b06bcb5f808/schema)