Sign in

v1

latestOpenAPI 3.0.12026-07-226992320.0 KB
Batch Runs

Create Batch Run

Triggers a new batch run by executing the specified test cases in parallel against the selected agent. Returns the created batch including its batchId, which is required for subsequent get and list test-run calls.

post/v1/batch-runs

Request body

agentIdstring required

The unique identifier of the Agent that will respond across all test cases in the batch simulation.

testCasesstring[] required

A list of test case IDs to be executed together in a single batch run. Each test case will be simulated independently against the specified Agent.

Example request

{
  "agentId": "D5D0p7TUs66TTAEAx",
  "testCases": [
    "tc_xeeXG5hX9dl0VFNt",
    "tc_aQqGZoMIPbU5MXHV"
  ]
}

Response

Created

batchIdstring

The unique identifier of the newly created batch run.

workspaceIdstring

The unique identifier of the workspace under which the batch run was created.

createdDatestring date-time

The UTC timestamp indicating when the batch run was created.

Example response

{
  "batchId": "batch_s0OJu2JWR8R45Fai",
  "workspaceId": "org_V6eZ2zg8ziDx5pft",
  "agent": {
    "name": "New AI Agent",
    "agentId": "agent_D5D0p7TUs66TTAEAx",
    "status": "Live"
  },
  "createdDate": "2026-03-26T10:52:45.565Z"
}