Get Circuit By Id
Get one stored circuit by ID, including its analytics snapshot.
Use this tool when the caller already holds a circuit_id and needs that
circuit alone. Prefer this over list_circuits_in_experiment for a single
known circuit, since listing an experiment returns every circuit it holds.
When to Use:
- Call this to read the analytics of a circuit produced by
transpile_circuits,compress_circuit_with_state_compression, orload_classical_data_with_data_loading. - Call this to compare a derived circuit against its parent after
list_children_circuitsreturns child IDs.
Constraints:
analyticsreflects what has been computed so far and isnulluntil an analytics job has run for the circuit. Usecompute_circuit_analyticsto populate it.- The response carries stored metadata and analytics, not the QASM source.
Notes:
- For agent-facing output, surface
name,status, and the key analytics fields such as qubits, depth, and two-qubit gate counts. - Access is granted when the caller can access the parent experiment.
Args: circuit_id: Circuit identifier from a prior MCP response. user: Authenticated user resolved from the API key. db: Active database session.
Returns: The stored circuit object enriched with MCP context text.
Raises:
HTTPException: Raised with 404 when the circuit or its experiment is
not available to the caller.
Authorizations
Path Parameters
Response
Successful Response
Extend a stored circuit model with MCP context text.
Attributes: context: ai summary describing the circuit role in the workflow.
Class for circuit analytics calculation job status.
Submitted, Running analytics computation, Core metrics computation is done, Advanced metrics computation is done, Parameterized QML metrics computation is done, Evolution computation is done, Done, Error Data model for circuit metrics.