---
title: "POST /create-batch-test"
method: POST
path: "/create-batch-test"
---

# POST /create-batch-test

`POST /create-batch-test`

Create a batch test to run multiple test cases

## Request body

- object
  - `test_case_definition_ids` string[], required — Array of test case definition IDs to run
  - `response_engine` union, required — Response engine for test cases. Custom LLM is not supported.
    - ResponseEngineRetellLm
      - `type` 'retell-llm', required — type of the Response Engine.
      - `llm_id` string, required — id of the Retell LLM Response Engine.
      - `version` number, nullable — Version of the Retell LLM Response Engine.
    - ResponseEngineConversationFlow
      - `type` 'conversation-flow', required — type of the Response Engine.
      - `conversation_flow_id` string, required — ID of the Conversation Flow Response Engine.
      - `version` number, nullable — Version of the Conversation Flow Response Engine.

## Response `201`

Test case batch job created successfully

- TestCaseBatchJob
  - `test_case_batch_job_id` string, required — Unique identifier for the test case batch job
  - `status` 'in_progress' | 'complete', required — Status of the batch job
  - `response_engine` union, required
    - ResponseEngineRetellLm
      - `type` 'retell-llm', required — type of the Response Engine.
      - `llm_id` string, required — id of the Retell LLM Response Engine.
      - `version` number, nullable — Version of the Retell LLM Response Engine.
    - ResponseEngineCustomLm
      - `type` 'custom-llm', required — type of the Response Engine.
      - `llm_websocket_url` string, required — LLM websocket url of the custom LLM.
    - ResponseEngineConversationFlow
      - `type` 'conversation-flow', required — type of the Response Engine.
      - `conversation_flow_id` string, required — ID of the Conversation Flow Response Engine.
      - `version` number, nullable — Version of the Conversation Flow Response Engine.
  - `pass_count` integer, required — Number of test cases that passed
  - `fail_count` integer, required — Number of test cases that failed
  - `error_count` integer, required — Number of test cases that encountered errors
  - `total_count` integer, required — Total number of test cases in the batch
  - `creation_timestamp` integer, required — Timestamp when the batch job was created (milliseconds since epoch)
  - `user_modified_timestamp` integer, required — Timestamp when the batch job was last modified (milliseconds since epoch)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/retellai/apis/retell-sdk.md) · [All operations](https://skmtc.net/retellai/apis/retell-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/retellai/retell-sdk/revisions/2a182bedbfc5/schema)