Skip to main content
POST
Run Hybrid Flow

Authorizations

HAIQU_API_KEY
string
query
required

Body

application/json

Define payload for a hybrid flow job.

Attributes: experiment_id: Parent experiment identifier. program: Hybrid program definition as a layer list. circuit_ids: Circuits the flow consumes. shots: Shots per circuit. name: Optional job name. description: Optional job description. parameters: Optional parameter bindings per circuit. observables: Optional observables per circuit. device_credentials: Backend credentials required by device layers. dry_run: Whether to validate the flow without executing it.

experiment_id
string
required
program
Program · object
required

Hybrid program as {'schema_version': 1, 'layers': [...]}, where each layer is an object with a type discriminator such as input, device, transpilation, estimator, or a mitigation layer. The layer set is validated server-side and documented in the Haiqu hybrid flow reference; build it with the SDK when unsure.

circuit_ids
string[]
required

Circuits the flow consumes, from prior MCP responses.

shots
integer
default:1000
name
string | null
default:""
description
string | null
default:""
parameters
any[] | null

Optional parameter bindings per circuit.

observables
tuple[][] | null

Optional observables per circuit, each as [[pauli_strings], [coefficients]].

device_credentials
Device Credentials · object

Credentials required by the flow's device layer, such as ibm_quantum_token.

dry_run
boolean
default:false

Validate and plan the flow without executing it. Use this first for an unfamiliar program.

Response

Successful Response

Represent context returned after a hybrid flow submission.

Attributes: job_id: Created job identifier. context: Submission summary and next polling step.

job_id
string
required
context
string
required