Skip to main content
POST

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json
display_name
string
required

Human-readable template name

Required string length: 1 - 200
Example:

"Voice Agent Daily Test"

agent_id
string
required

Agent to test (must exist and be accessible)

Pattern: ^[A-Za-z0-9]{22}$
Example:

"gk3jK9mPq2xRt5vW8yZaBc"

persona_id
string
required

Simulated persona to use (must exist)

Pattern: ^[A-Za-z0-9]{22}$
Example:

"hL4kL0nQr3ySt6vX9zAcDd"

test_set_id
string
required

Test set containing test cases (must exist)

Pattern: ^[A-Za-z0-9]{8}$
Example:

"aB1cD2eF"

description
string
default:""

Optional description

Example:

"Daily regression test for voice agent"

metric_ids
string[]

Metrics to evaluate (uses agent defaults if empty)

Pattern: ^[A-Za-z0-9]{22}$
Example:
mutation_ids
string[]

Mutations for A/B testing

Pattern: ^[A-Za-z0-9]{26}$
Example:
iteration_count
integer
default:1

Number of times to run each test case

Required range: 1 <= x <= 100
Example:

3

concurrency
integer
default:1

Number of simulations to run concurrently

Required range: 1 <= x <= 50
Example:

5

sub_sample_size
integer
default:0

Number of test cases to randomly sample (0 = use all)

Required range: x >= 0
Example:

0

sub_sample_seed
integer | null

Random seed for reproducible sub-sampling

Example:

null

metadata
object

Custom metadata for tracking

Example:
tags
string[] | null

Tags to associate with this run template. Null or omitted creates the run template with no tags. Pass [] for an empty tag list.

Example:

Response

Run template created successfully

run_template
object
required

Run template configuration resource.