---
title: "Create a durable Quantum Reasoning Lab job"
method: POST
path: "/bee/quantum-reasoning/jobs"
---

# Create a durable Quantum Reasoning Lab job

`POST /bee/quantum-reasoning/jobs`

## Request

- Base URL: `https://api.bee.heossi.com`
- URL: `https://api.bee.heossi.com/bee/quantum-reasoning/jobs`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- QuantumReasoningJobCreate
  - `prompt` string, required
  - `model` 'bee-hive' | 'bee-swarm', required
  - `product` 'simulation_cloud' | 'managed_qpu' | 'byopa_managed', required
  - `provider_connection_id` string, uuid, nullable
  - `workspace_id` string, uuid, nullable

## Response `200`

Existing job returned for the same idempotency key and request

- QuantumReasoningJobEnvelope
  - `job` QuantumReasoningJob, required
    - `id` string, uuid, required
    - `status` 'queued' | 'generating_candidates' | 'scoring' | 'selecting' | 'awaiting_qpu' | 'completed' | 'classical_fallback' | 'failed' | 'cancelled', required
    - `model` 'bee-hive' | 'bee-swarm', required
    - `scoring_method` 'hive_logprob' | 'swarm_judge', required
    - `requested_real` boolean, required
    - `prompt` string
    - `candidates` object[]
    - `selected_index` integer
    - `result` string
    - `selector_backend` string
    - `selector_confidence` number
    - `used_real_qubits` boolean, required
    - `quoted_credits` number, nullable
    - `fallback_reason` 'selector_unreachable' | 'invalid_selection', nullable
    - `real_request_status` 'not_requested' | 'reserved' | 'executed' | 'provider_used_simulator' | 'quantum_not_enabled' | 'quantum_allowance_exhausted' | 'released_after_failure', required
    - `usage` object, required
    - `inference_receipt_id` string, uuid, nullable
    - `attempt_count` integer, required
    - `max_attempts` integer, required
    - `next_attempt_at` string, date-time, nullable
    - `outcome_state` 'not_started' | 'in_progress' | 'committed' | 'outcome_unknown' | 'reconciled', required
    - `error` object, nullable
      - `code` string, required
      - `message` string, required
    - `workspace_id` string, uuid, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `completed_at` string, date-time, nullable

## Other responses

- `202`: Job queued
- `403`: Model or real-QPU entitlement denied
- `409`: Idempotency key was reused with different input
- `429`: Per-tenant queue limit reached
- `503`: Quantum Reasoning Lab is disabled

---

[API](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api.md) · [All operations](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heossi/apis/bee-quantum-intelligence-developer-api/revisions/285f9cfc359b?raw)