Experiments

List Runs of an experiment (live)

Changed on Aug 29, 2026

get/api/v1/experiments/{name}/runs

Request

Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/v1/experiments/{name}/runs
Auth: none declared

Path parameters

namestring required

Query parameters

Run (compute MLRun) phase. The active (non-terminal) phases — Creating / Pending / Running / Canceling — block Job-definition deletion.

limitinteger

Page size (default 50, max 200).

continuestring

Opaque continue token from the previous response.

Headers

X-Axisml-Tenantstring

Active tenant for the request (fallback for the axisml.tenant cookie).

Response

A page of Runs.

continueTokenstring

Opaque token to fetch the next page.

countinteger required

Number of runs in this page.

partialboolean

True if the list was truncated by an upstream limit.

Example response

{
  "continueToken": "",
  "count": 1,
  "items": [
    {
      "backend": {
        "engine": "pytorchjob",
        "name": "native"
      },
      "computeNamespace": "axisml-team-vision",
      "createdAt": "2026-06-28T09:00:00Z",
      "description": "Distributed ResNet-50 training run on ImageNet.",
      "displayName": "ResNet-50 Training #7",
      "id": "b7d9e3f1-1a2b-3c4d-5e6f-708192a3b4c5",
      "jobName": "resnet-train",
      "message": "All worker replicas ready.",
      "name": "resnet-train-7",
      "namespace": "team-vision",
      "owner": "li.wei",
      "ownerId": "3a2b1c0d-4e5f-6789-abcd-ef0123456789",
      "phase": "Running",
      "poolName": "gpu-a100",
      "resources": {
        "cpu": "32",
        "memory": "256Gi",
        "nvidia.com/gpu": "8"
      },
      "roles": [
        {
          "activeReplicas": 4,
          "failedReplicas": 0,
          "name": "worker",
          "readyReplicas": 4,
          "replicas": 4,
          "restartPolicy": "OnFailure",
          "succeededReplicas": 0,
          "template": {
            "args": [
              "--epochs",
              "90",
              "--batch-size",
              "256"
            ],
            "command": [
              "python",
              "train.py"
            ],
            "env": [
              {
                "name": "NCCL_DEBUG",
                "value": "INFO"
              }
            ],
            "envFrom": [
              {
                "configMapRef": {
                  "name": "resnet-training-config"
                }
              }
            ],
            "image": "registry.axisml.io/training/resnet:1.4.0",
            "ports": [
              {
                "containerPort": 8080,
                "name": "http",
                "protocol": "TCP"
              }
            ],
            "resources": {
              "cpu": "8",
              "memory": "64Gi",
              "nvidia.com/gpu": "2"
            },
            "volumeMounts": [
              {
                "mountPath": "/data",
                "name": "data"
              },
              {
                "mountPath": "/etc/axisml",
                "name": "config",
                "readOnly": true
              }
            ],
            "volumes": [
              {
                "name": "data",
                "persistentVolumeClaim": {
                  "claimName": "resnet-imagenet"
                }
              },
              {
                "configMap": {
                  "name": "resnet-training-config"
                },
                "name": "config"
              }
            ]
          }
        }
      ],
      "runNumber": 7,
      "runPolicy": {
        "activeDeadlineSeconds": 86400,
        "backoffLimit": 2,
        "progressDeadlineSeconds": 600,
        "ttlSecondsAfterFinished": 3600
      },
      "scheduledAt": "2026-06-28T09:00:00Z",
      "spec": {
        "backend": {
          "engine": "pytorchjob",
          "name": "native"
        },
        "configMaps": [
          {
            "data": {
              "trainer.yaml": "epochs: 90\nbatchSize: 256\n"
            },
            "name": "resnet-training-config"
          }
        ],
        "roles": [
          {
            "name": "worker",
            "replicas": 4,
            "restartPolicy": "OnFailure",
            "template": {
              "args": [
                "--epochs",
                "90",
                "--batch-size",
                "256"
              ],
              "command": [
                "python",
                "train.py"
              ],
              "env": [
                {
                  "name": "NCCL_DEBUG",
                  "value": "INFO"
                }
              ],
              "envFrom": [
                {
                  "configMapRef": {
                    "name": "resnet-training-config"
                  }
                }
              ],
              "image": "registry.axisml.io/training/resnet:1.4.0",
              "ports": [
                {
                  "containerPort": 8080,
                  "name": "http",
                  "protocol": "TCP"
                }
              ],
              "resources": {
                "cpu": "8",
                "memory": "64Gi",
                "nvidia.com/gpu": "2"
              },
              "volumeMounts": [
                {
                  "mountPath": "/data",
                  "name": "data"
                },
                {
                  "mountPath": "/etc/axisml",
                  "name": "config",
                  "readOnly": true
                }
              ],
              "volumes": [
                {
                  "name": "data",
                  "persistentVolumeClaim": {
                    "claimName": "resnet-imagenet"
                  }
                },
                {
                  "configMap": {
                    "name": "resnet-training-config"
                  },
                  "name": "config"
                }
              ]
            }
          }
        ],
        "runPolicy": {
          "activeDeadlineSeconds": 86400,
          "backoffLimit": 2,
          "progressDeadlineSeconds": 600,
          "ttlSecondsAfterFinished": 3600
        },
        "scheduling": {
          "minMember": 4,
          "priorityClass": "high-priority",
          "quota": "axisml-team-vision-gpu-a100"
        }
      },
      "startedAt": "2026-06-28T09:00:00Z",
      "tenantDisplayName": "Vision Team",
      "tenantName": "team-vision",
      "unitName": "a100-2x",
      "updatedAt": "2026-06-28T09:30:00Z"
    }
  ],
  "partial": false
}

Changes

Aug 29, 20262460d3212e9b Revision changes
- warning
  added the new Queued enum value to the ////// response property for the response status
- info
  added the new enum value Queued to the query request parameter phase
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status
Jul 19, 2026d00d802bd072 Revision changes
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////////// to the response with the status

Operation history (5 revisions)