Submit a quantum circuit defined by QASM string and compute its core metrics. A bunch of useful analytics are computed for the circuit and stored in the database, such as qubits, depth, depth_2q, gates_1q, gates_2q, gates_total, etc.
The circuit then could be used in the run_circuits_on_qpu_or_simulator tool
by providing its ID in the circuit_ids field or in the compression tool
compress_circuit_with_state_compression.
This endpoint allows AI agents to create new circuits in the database by providing their QASM representation. The created circuit is associated with the specified experiment and becomes visible in the Haiqu Dashboard and Haiqu Lab UI for future reference or execution.
Args: user (User): User authenticated with the API key. data (ContextCircuitSubmitModel): Circuit submission parameters. db (Session): Database session.
Returns: ContextCircuitModel: Information about the newly created circuit.
Circuit submit payload data model.
ID of the experiment to which the circuit belongs.
Quantum circuit in QASM 2.0 or 3.0 format.
The name of the circuit.
Short explanation of why this circuit is being created.
The description of the circuit.
Successful Response
Circuit model with the context for AI/MCP endpoints.
Class for circuit analytics calculation job status.
Submitted, Running analytics computation, Core metrics computation is done, Advanced metrics computation is done, Evolution computation is done, Done, Error Data model for circuit metrics.