---
title: "Create a server-bound Hex operation proposal"
method: POST
path: "/v1/eve/operations/proposals"
tags: ["Hex", "Public"]
---

# Create a server-bound Hex operation proposal

`POST /v1/eve/operations/proposals`

Validates an untrusted operation draft and returns the payload-free, server-authored consent card. Reusing an idempotency key returns the original proposal.

## Request body

- object
  - `contractVersion` 1, required
  - `operationType` string, required
  - `target` object
  - `payload` object, required
  - `idempotencyKey` string, required
  - `conversationId` unknown
  - `clientConversationId` unknown
  - `commandSource` string

## 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
  - `replayed` boolean, required

## Other responses

- `201` — Default Response
- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response
- `422` — 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)