List Jobs For Circuit
List jobs that reference a circuit directly or through derivatives.
Use this tool when the caller has a circuit_id and needs the full job
history tied to that circuit, including direct execution links plus
compression and transpilation relations.
When to Use:
- Call this when the workflow starts from a known circuit and the next step is to inspect related execution, compression, or transpilation jobs.
- Call this before
get_job_results_and_statuswhen the caller does not yet know the relevantjob_id.
Constraints:
- The route aggregates multiple relation paths and may therefore return heterogeneous job families.
- The implementation does not deduplicate jobs that match more than one relation path.
Notes:
- Returned
job.idvalues can be forwarded toget_job_results_and_statusfor detailed status or results. - Agent-facing summaries should group returned jobs by type and status before expanding full records.
Args: circuit_id: Circuit identifier from a prior MCP response. user: Authenticated user resolved from the API key. db: Active database session.
Returns: A list of job objects related to the circuit.
Raises:
HTTPException: Raised with 404 when the parent circuit or its
experiment is not available to the caller.
Authorizations
Path Parameters
Response
Successful Response
Class for job status.
Submitted, Initializing, Queued, Validating, Running, Cancelled, Done, Error Class for job types.
User local job, Analytics, Device specific analytics, Data Loading, Run, State Compression, Transpilation, Variational, Pretraining, SKQD