List Jobs

curl --request GET \
  --url 'https://api.example.com/ai/{experiment_id}/jobs?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "user_id": 123,
    "experiment_id": "<string>",
    "creation_date": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "description": "<string>",
    "device_id": "Haiqu OS",
    "run_date": "2023-11-07T05:31:56Z",
    "finish_date": "2023-11-07T05:31:56Z",
    "logs": "<string>",
    "quality": 123,
    "info": {},
    "time": 123,
    "parameters": {}
  }
]

API Reference

List Jobs

List jobs associated with an experiment.

Use this tool when the caller needs execution, compression, analytics, or related job history under one experiment. Returned job.id values can be passed directly to get_job_results_and_status.

When to Use:

Call this when the workflow already has an experiment_id but not the relevant job_id.
Call this to inspect the complete job history for one experiment before polling individual jobs.

Constraints:

The result may contain heterogeneous job families.
limit caps the number of returned jobs.

Notes:

Returned job.id values can be passed directly to get_job_results_and_status.
Agent-facing output should group jobs by type and status before expanding individual records.

Args: experiment_id: Parent experiment identifier. user: Authenticated user resolved from the API key. db: Active database session. limit: Maximum number of jobs to return. Defaults to 100.

Returns: A list of job objects capped by limit.

Raises: HTTPException: Raised with 404 when the experiment is not available to the caller.

GET

{experiment_id}

jobs

List Jobs

curl --request GET \
  --url 'https://api.example.com/ai/{experiment_id}/jobs?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "user_id": 123,
    "experiment_id": "<string>",
    "creation_date": "2023-11-07T05:31:56Z",
    "name": "<string>",
    "description": "<string>",
    "device_id": "Haiqu OS",
    "run_date": "2023-11-07T05:31:56Z",
    "finish_date": "2023-11-07T05:31:56Z",
    "logs": "<string>",
    "quality": 123,
    "info": {},
    "time": 123,
    "parameters": {}
  }
]

Authorizations

HAIQU_API_KEY

string

query

required

Path Parameters

experiment_id

string

required

Query Parameters

limit

integer

default:100

Response

Successful Response

string

required

user_id

integer

required

experiment_id

string

required

status

enum<string>

required

Class for job status.

Available options:

Submitted,

Initializing,

Queued,

Validating,

Running,

Cancelled,

Done,

Error

job_type

enum<string>

required

Class for job types.

Available options:

User local job,

Analytics,

Device specific analytics,

Data Loading,

Run,

State Compression,

Transpilation,

Variational,

Pretraining,

SKQD

creation_date

string<date-time>

required

name

string | null

description

string | null

device_id

string | null

default:Haiqu OS

run_date

string<date-time> | null

finish_date

string<date-time> | null

logs

string | null

quality

number | null

info

Info · object

time

number | null

parameters

List Circuits In Experiment Log Artifact In Experiment

⌘I