Skip to main content
POST
Create test execution

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

job
string<uuid>
required

Denormalized from cohort for efficient job-level queries

test_slug
enum<string>
required
  • multi-node.hello-world - multi-node.hello-world
  • multi-node.iperf-matrix - multi-node.iperf-matrix
  • multi-node.nccl-all-gather - multi-node.nccl-all-gather
  • multi-node.nccl-all-reduce - multi-node.nccl-all-reduce
  • multi-node.nccl-all-reduce-multi-rack - multi-node.nccl-all-reduce-multi-rack
  • multi-node.nccl-all-to-all - multi-node.nccl-all-to-all
  • multi-node.nvloom - multi-node.nvloom
  • multi-node.pairwise-net-gpu.bw - multi-node.pairwise-net-gpu.bw
  • multi-node.pairwise-net-gpu.lat - multi-node.pairwise-net-gpu.lat
  • multi-node.pairwise-net.bw - multi-node.pairwise-net.bw
  • multi-node.pairwise-net.lat - multi-node.pairwise-net.lat
  • multi-node.s3-elbencho - multi-node.s3-elbencho
  • multi-node.storage-elbencho - multi-node.storage-elbencho
  • multi-node.training-gpt-oss-120b - multi-node.training-gpt-oss-120b
  • multi-node.training-llama3-1-405b - multi-node.training-llama3-1-405b
  • multi-node.training-llama3-70b - multi-node.training-llama3-70b
  • multi-node.training-nemotron-24x2h - multi-node.training-nemotron-24x2h
  • multi-node.training-nemotron-checkpoint - multi-node.training-nemotron-checkpoint
  • multi-node.training-nemotron-h - multi-node.training-nemotron-h
  • multi-node.training-nemotron-h-multi-rack - multi-node.training-nemotron-h-multi-rack
  • multi-node.training-qwen3-235b - multi-node.training-qwen3-235b
  • single-node.babelstream - single-node.babelstream
  • single-node.dcgmi-diag - single-node.dcgmi-diag
  • single-node.gpu-fryer - single-node.gpu-fryer
  • single-node.hello-world - single-node.hello-world
  • single-node.hpl-cpu - single-node.hpl-cpu
  • single-node.hpl-gpu - single-node.hpl-gpu
  • single-node.lmbench-lat-mem-rd - single-node.lmbench-lat-mem-rd
  • single-node.memtester - single-node.memtester
  • single-node.nccl-all-gather - single-node.nccl-all-gather
  • single-node.nccl-all-reduce - single-node.nccl-all-reduce
  • single-node.nccl-all-reduce-loopback - single-node.nccl-all-reduce-loopback
  • single-node.nccl-all-to-all - single-node.nccl-all-to-all
  • single-node.node-health-check - single-node.node-health-check
  • single-node.nvme-fio - single-node.nvme-fio
  • single-node.nvme-self-test - single-node.nvme-self-test
  • single-node.storage-elbencho - single-node.storage-elbencho
  • single-node.stream - single-node.stream
  • single-node.stress-ng-cpu - single-node.stress-ng-cpu
  • single-node.training-llama3-8b - single-node.training-llama3-8b
  • single-node.training-nemotronh-8b - single-node.training-nemotronh-8b
Available options:
multi-node.hello-world,
multi-node.iperf-matrix,
multi-node.nccl-all-gather,
multi-node.nccl-all-reduce,
multi-node.nccl-all-reduce-multi-rack,
multi-node.nccl-all-to-all,
multi-node.nvloom,
multi-node.pairwise-net-gpu.bw,
multi-node.pairwise-net-gpu.lat,
multi-node.pairwise-net.bw,
multi-node.pairwise-net.lat,
multi-node.s3-elbencho,
multi-node.storage-elbencho,
multi-node.training-gpt-oss-120b,
multi-node.training-llama3-1-405b,
multi-node.training-llama3-70b,
multi-node.training-nemotron-24x2h,
multi-node.training-nemotron-checkpoint,
multi-node.training-nemotron-h,
multi-node.training-nemotron-h-multi-rack,
multi-node.training-qwen3-235b,
single-node.babelstream,
single-node.dcgmi-diag,
single-node.gpu-fryer,
single-node.hello-world,
single-node.hpl-cpu,
single-node.hpl-gpu,
single-node.lmbench-lat-mem-rd,
single-node.memtester,
single-node.nccl-all-gather,
single-node.nccl-all-reduce,
single-node.nccl-all-reduce-loopback,
single-node.nccl-all-to-all,
single-node.node-health-check,
single-node.nvme-fio,
single-node.nvme-self-test,
single-node.storage-elbencho,
single-node.stream,
single-node.stress-ng-cpu,
single-node.training-llama3-8b,
single-node.training-nemotronh-8b
stage
enum<string>
required

Test stage (denormalized from test_slug for efficient filtering)

  • single_node - Single Node
  • pairwise - Pairwise
  • collective - Collective
Available options:
single_node,
pairwise,
collective
status
enum<string>
required

Test execution status (must be set explicitly - no default)

  • completed - Completed
  • passed - Passed
  • failed - Failed
  • error - Error
Available options:
completed,
passed,
failed,
error
cohort
string<uuid> | null

Cohort UUID. Either cohort or device_ids must be provided.

device_ids
string<uuid>[]
write-only

List of device UUIDs. If provided instead of cohort, will automatically create/retrieve cohort (max 25000).

Maximum array length: 25000
parent_cohort
string<uuid> | null
write-only

Optional parent cohort for hierarchical tracking (used with device_ids).

source_device
string<uuid> | null
write-only

Source device for pairwise tests (used when creating cohort with device_ids)

dest_device
string<uuid> | null
write-only

Destination device for pairwise tests (used when creating cohort with device_ids)

resolved_params
object | null

Resolved test parameters that actually ran. The resolved params key is derived server-side from this JSON.

metrics
object · null · null
iteration_summary
object | null

OpenAPI schema for iteration execution summary.

error_details
object | null

Structured error information for infrastructure failures (status=ERROR)

nic_metrics
any | null

Per-NIC metrics for pairwise tests (list of per-NIC result dicts)

artifact_uri
string

S3 URI to test artifacts (e.g., 's3://bucket/org/site/job/cohort/')

Maximum string length: 1000
started_at
string<date-time> | null
completed_at
string<date-time> | null
slurm_job_id
integer | null

SLURM job ID for hardware test execution (burn-in workflows only)

Required range: 0 <= x <= 2147483647

Response

count
integer
required
Example:

123

results
object[]
required
next
string<uri> | null
Example:

"http://api.example.org/accounts/?page=4"

previous
string<uri> | null
Example:

"http://api.example.org/accounts/?page=2"