Experiments

Get an experiment

Changed on
get/api/v1/experiments/{name}

Request

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

Path parameters

namestring required

Headers

X-Axisml-Tenantstring

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

Response

Experiment detail.

annotationsStringMap
createdAtstring date-time required

Time the experiment was created.

descriptionstring

Free-text experiment description.

displayNamestring

Human-readable experiment label.

idstring uuid required

Stable experiment identifier.

labelsStringMap
namestring required

Experiment definition name (unique within the tenant).

namespacestring required

Platform tenant namespace the experiment belongs to.

ownerstring required

Username of the experiment owner.

ownerIdstring uuid

User ID of the experiment owner.

tenantNamestring required

Tenant identifier owning the experiment.

updatedAtstring date-time required

Time the experiment was last updated.

Example response

{
  "annotations": {
    "axisml.io/created-by": "li.wei"
  },
  "createdAt": "2026-06-20T08:00:00Z",
  "description": "Training experiment fine-tuning BERT on a Chinese corpus.",
  "displayName": "BERT fine-tuning experiment",
  "id": "d4f8a1b2-3c5e-4a7b-9c0d-1e2f3a4b5c6d",
  "labels": {
    "team": "nlp"
  },
  "name": "bert-finetune",
  "namespace": "team-nlp",
  "owner": "zhang.san",
  "ownerId": "3a2b1c0d-4e5f-6789-abcd-ef0123456789",
  "runSummary": {
    "active": 1,
    "count": 5,
    "latestPhase": "Succeeded",
    "latestRunAt": "2026-06-28T09:25:00Z",
    "recent": [
      "Succeeded",
      "Running",
      "Succeeded",
      "Failed",
      "Succeeded"
    ]
  },
  "spec": {
    "artifacts": [
      {
        "kind": "model",
        "name": "bert-base",
        "version": "2.1.0"
      }
    ],
    "backend": {
      "engine": "pytorchjob",
      "name": "kubeflow-trainer"
    },
    "poolName": "gpu-a100",
    "roles": [
      {
        "name": "worker",
        "replicas": 2,
        "restartPolicy": "OnFailure",
        "template": {
          "args": [
            "--lr",
            "0.001",
            "--epochs",
            "10",
            "--batch-size",
            "64"
          ],
          "command": [
            "python",
            "train.py"
          ],
          "env": [
            {
              "name": "WANDB_MODE",
              "value": "offline"
            }
          ],
          "image": "registry.axisml.io/training/bert:2.1.0",
          "resources": {
            "cpu": "8",
            "memory": "64Gi",
            "nvidia.com/gpu": "2"
          }
        }
      }
    ],
    "runPolicy": {
      "activeDeadlineSeconds": 86400,
      "backoffLimit": 2,
      "ttlSecondsAfterFinished": 3600
    },
    "unitName": "a100-2x"
  },
  "tenantName": "team-nlp",
  "updatedAt": "2026-06-28T09:30:00Z"
}

Changes

    • warning

      removed the optional property ///// from 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

    • info

      added the optional property //////////// to the response with the status

    • warning

      added the new Queued enum value to the ///////// response property for the response status

    • warning

      added the new Queued enum value to the ////// response property for the response status