For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
OverviewCodaControlAPI ReferenceChangelog
OverviewCodaControlAPI ReferenceChangelog
  • Coda API
      • GETList QPUs
      • POSTRun QPU
      • POSTQPU Status
      • POSTEstimate QPU Cost
  • Control API
  • Stanza API
    • stanza
    • cli
    • context
    • device
    • exceptions
    • models
    • pyvisa
    • registry
    • timing
    • utils
LogoLogo
Coda APIQPUs

Run QPU

POST
https://api.conductorquantum.com/v0/coda/qpus
POST
/v0/coda/qpus
1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<token>")
4result = client.coda.qpus.run(
5 code="from qiskit import QuantumCircuit\nqc = QuantumCircuit(2)\nqc.h(0)\nqc.cx(0, 1)\nqc.measure_all()",
6 source_framework="qiskit",
7 backend="iqm",
8 shots=100,
9)
10print(result)
1{
2 "success": true,
3 "job_id": "7f6c6b6a-2f7d-4b84-8f59-2ee3b4f49d8a",
4 "status": "submitted",
5 "backend": "iqm",
6 "shots": 100,
7 "estimated_cost_cents": 130,
8 "credits_applied": 2,
9 "overage_cents": 0
10}
Submit a quantum circuit to real QPU hardware. Circuits are automatically converted to the target device's native format. Returns a job ID for tracking.
Was this page helpful?
Built with

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
codestringRequired
Circuit code in any supported source framework
source_frameworkstringRequired

Framework name for code

backendstringRequired
Target device
shotsintegerOptional10-10000Defaults to 100
accept_overagebooleanOptionalDefaults to false
Acknowledge overage charges if credits insufficient
braket_execution_mode_hintstring or nullOptional

Optional: ‘program_set’ or ‘run_batch’ for multi-circuit cost alignment.

Response

Successful Response
successboolean
job_idstring
statusstring
backendstring
shotsinteger

Errors

422
Unprocessable Entity Error