Retell AI Create Batch Test API
The Create Batch Test API from Retell AI — 1 operation(s) for create batch test.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/retell-ai-create-batch-test-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Retell SDK Add Community Voice Create Batch Test API
version: 3.0.0
contact:
name: Retell Support
url: https://www.retellai.com/
email: support@retellai.com
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://api.retellai.com
description: The production server.
security:
- api_key: []
tags:
- name: Create Batch Test
paths:
/create-batch-test:
post:
description: Create a batch test to run multiple test cases
operationId: createBatchTest
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- test_case_definition_ids
- response_engine
properties:
test_case_definition_ids:
type: array
minItems: 1
maxItems: 1000
items:
type: string
description: Array of test case definition IDs to run
response_engine:
$ref: '#/components/schemas/RetellResponseEngine'
description: Response engine to use for the test cases. Custom LLM is not supported.
responses:
'201':
description: Test case batch job created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/TestCaseBatchJob'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'402':
$ref: '#/components/responses/PaymentRequired'
'429':
$ref: '#/components/responses/TooManyRequests'
'500':
$ref: '#/components/responses/InternalServerError'
tags:
- Create Batch Test
components:
responses:
Unauthorized:
description: Unauthorized
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: API key is missing or invalid.
PaymentRequired:
description: Payment Required
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: Trial has ended, please add payment method.
InternalServerError:
description: Internal Server Error
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: An unexpected server error occurred.
BadRequest:
description: Bad Request
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: Invalid request format, please check API reference.
TooManyRequests:
description: Too Many Requests
content:
application/json:
schema:
type: object
properties:
status:
type: string
enum:
- error
message:
type: string
example: Account rate limited, please throttle your requests.
schemas:
RetellResponseEngine:
oneOf:
- $ref: '#/components/schemas/ResponseEngineRetellLm'
- $ref: '#/components/schemas/ResponseEngineConversationFlow'
description: Response engine for test cases. Custom LLM is not supported.
TestCaseBatchJob:
type: object
required:
- test_case_batch_job_id
- status
- response_engine
- pass_count
- fail_count
- error_count
- total_count
- creation_timestamp
- user_modified_timestamp
properties:
test_case_batch_job_id:
type: string
description: Unique identifier for the test case batch job
status:
type: string
enum:
- in_progress
- complete
description: Status of the batch job
response_engine:
$ref: '#/components/schemas/ResponseEngine'
pass_count:
type: integer
description: Number of test cases that passed
minimum: 0
fail_count:
type: integer
description: Number of test cases that failed
minimum: 0
error_count:
type: integer
description: Number of test cases that encountered errors
minimum: 0
total_count:
type: integer
description: Total number of test cases in the batch
minimum: 0
creation_timestamp:
type: integer
description: Timestamp when the batch job was created (milliseconds since epoch)
user_modified_timestamp:
type: integer
description: Timestamp when the batch job was last modified (milliseconds since epoch)
ResponseEngineCustomLm:
type: object
required:
- type
- llm_websocket_url
properties:
type:
type: string
enum:
- custom-llm
description: type of the Response Engine.
llm_websocket_url:
type: string
description: LLM websocket url of the custom LLM.
ResponseEngineRetellLm:
type: object
required:
- type
- llm_id
properties:
type:
type: string
enum:
- retell-llm
description: type of the Response Engine.
llm_id:
type: string
description: id of the Retell LLM Response Engine.
version:
type:
- number
- 'null'
example: 0
description: Version of the Retell LLM Response Engine.
ResponseEngineConversationFlow:
type: object
required:
- type
- conversation_flow_id
properties:
type:
type: string
enum:
- conversation-flow
description: type of the Response Engine.
conversation_flow_id:
type: string
description: ID of the Conversation Flow Response Engine.
version:
type:
- number
- 'null'
example: 0
description: Version of the Conversation Flow Response Engine.
ResponseEngine:
oneOf:
- $ref: '#/components/schemas/ResponseEngineRetellLm'
- $ref: '#/components/schemas/ResponseEngineCustomLm'
- $ref: '#/components/schemas/ResponseEngineConversationFlow'
securitySchemes:
api_key:
type: http
scheme: bearer
bearerFormat: string
description: Authentication header containing API key (find it in dashboard). The format is "Bearer YOUR_API_KEY"