---
title: "Create Batch Run"
method: POST
path: "/v1/batch-runs"
tags: ["Batch Runs"]
---

# Create Batch Run

`POST /v1/batch-runs`

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.

## Request body

- BatchRunRequest
  - `agentId` string, required — The unique identifier of the Agent that will respond across all test cases in the batch simulation.
  - `testCases` string[], 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.

## Response `201`

Created

- CreateBatchRunResponse
  - `batchId` string — The unique identifier of the newly created batch run.
  - `workspaceId` string — The unique identifier of the workspace under which the batch run was created.
  - `agent` AgentResponse — Agent assigned to handle all calls in this campaign. Contains the agent's ID, name, and current status. All contacts in the campaign's contact list will be called using this agent.
    - `name` string — The display name of the assigned agent.
    - `agentId` string — The unique identifier of the agent within the system.
    - `status` 'Live' | 'Testing' | 'Disabled' — The current operational status of the agent.
  - `createdDate` string, date-time — The UTC timestamp indicating when the batch run was created.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/sigmamind/apis/sigmamind-apis.md) · [All operations](https://skmtc.net/sigmamind/apis/sigmamind-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sigmamind/sigmamind-apis/versions/d00f52b5123f/schema)