Compress Circuit With State Compression
Submit a quantum circuit compression job(s) using state compression.
This endpoint validates the request and creates a new compression job(s). You
can provide either an existing circuit_ids or a circuit_qasm payload. If
only circuit_qasm is provided, a new circuit record is created first.
The batch of compression jobs could be submitted via circuit_ids. If both
circuit_ids and circuit_id are provided, circuit_ids will be used and
circuit_id will be ignored, it is deprecated.
Args:
user (User): The user authenticated with an API key.
data (ContextStateCompressionSubmitModel): Request payload containing
the circuit reference (circuit_id) or circuit source
(circuit_qasm), plus context metadata.
db (Session): Active database session.
Returns: ContextStateCompressionJobModel: Details about the newly created compression job including the job ID and circuit reference.
Authorizations
Body
State compression job submission model usable by AI agents.
State compression options: compression_level (low|balanced|high), noise_profile (e.g. default, ibm_heron_r2, iqm_garnet), fine_tuning (disabled|low|heavy), and optional approximation_level (int or null).
List of existing circuit IDs to compress.
Name for the circuit to compress. Required if circuit_qasm is provided without circuit_id.
ID of the existing circuit to compress. Deprecated.
Quantum circuit in QASM 2.0 or 3.0 format. Use either this field or circuit_id field to specify the existing circuit ID to compress.
Response
Successful Response
State Compression Job model with MCP context.