Skip to navigation
Coda APIQPUs

Run QPU

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. Optional team_id bills an Enterprise team wallet. Personal tokens bill the personal wallet unless team_id is set. Team service-account keys always bill their team. A mismatched team_id returns 400. There is no fallback to the personal wallet.

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.

team_idstring or nullOptional

Optional Enterprise team wallet to bill. Personal tokens bill the personal wallet unless team_id is set. Team service-account keys always bill their team. A mismatched team_id returns 400. There is no fallback to the personal wallet.

Response

Successful Response
successboolean
job_idstring
statusstring
backendstring
shotsintegerOptional

Errors

422
Unprocessable Entity Error