curl --request POST \
--url https://api.coval.dev/v1/run-templates \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "Voice Agent Test",
"agent_ids": [
"gk3jK9mPq2xRt5vW8yZaBc"
],
"persona_ids": [
"hL4kL0nQr3ySt6vX9zAcDd"
],
"test_set_ids": [
"aB1cD2eF"
]
}
'{
"run_template": {
"name": "run-templates/abc123def456ghi789jklm",
"created_at": "2025-10-14T12:00:00Z",
"created_by": "01J000000000000000000000001",
"updated_at": null,
"updated_by": null,
"id": "abc123def456ghi789jklm",
"display_name": "Voice Agent Test",
"description": "",
"agent_ids": [
"gk3jK9mPq2xRt5vW8yZaBc"
],
"persona_ids": [
"hL4kL0nQr3ySt6vX9zAcDd"
],
"test_set_ids": [
"aB1cD2eF"
],
"metric_ids": [],
"mutation_ids": [],
"iteration_count": 1,
"concurrency": 1,
"sub_sample_size": 0,
"sub_sample_seed": null,
"metadata": {},
"create_time": "2025-10-14T12:00:00Z",
"update_time": null
}
}Create run template
Create a new run template with a reusable run configuration.
Templates capture all parameters needed to launch a run: the agent to test, persona to simulate, test set to use, and optional metrics and execution settings.
curl --request POST \
--url https://api.coval.dev/v1/run-templates \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "Voice Agent Test",
"agent_ids": [
"gk3jK9mPq2xRt5vW8yZaBc"
],
"persona_ids": [
"hL4kL0nQr3ySt6vX9zAcDd"
],
"test_set_ids": [
"aB1cD2eF"
]
}
'{
"run_template": {
"name": "run-templates/abc123def456ghi789jklm",
"created_at": "2025-10-14T12:00:00Z",
"created_by": "01J000000000000000000000001",
"updated_at": null,
"updated_by": null,
"id": "abc123def456ghi789jklm",
"display_name": "Voice Agent Test",
"description": "",
"agent_ids": [
"gk3jK9mPq2xRt5vW8yZaBc"
],
"persona_ids": [
"hL4kL0nQr3ySt6vX9zAcDd"
],
"test_set_ids": [
"aB1cD2eF"
],
"metric_ids": [],
"mutation_ids": [],
"iteration_count": 1,
"concurrency": 1,
"sub_sample_size": 0,
"sub_sample_seed": null,
"metadata": {},
"create_time": "2025-10-14T12:00:00Z",
"update_time": null
}
}Authorizations
API key for authentication
Headers
Workspace that scopes this operation. When omitted, the organization's active default workspace is used when one can be resolved.
1 - 26Body
Human-readable template name
1 - 200"Voice Agent Daily Test"
Agents to test. Every agent must exist and be accessible.
1^[A-Za-z0-9]{22}$["gk3jK9mPq2xRt5vW8yZaBc"]
Simulated personas to use. Every persona must exist.
1^[A-Za-z0-9]{22}$["hL4kL0nQr3ySt6vX9zAcDd"]
Test sets containing test cases. Every test set must exist.
1^[A-Za-z0-9]{8}$["aB1cD2eF"]
Optional description
"Daily regression test for voice agent"
Metrics to evaluate (uses agent defaults if empty)
^[A-Za-z0-9]{22}$["iM5lM1oRs4zTu7wY0aBdEe"]
Mutations for A/B testing
^[A-Za-z0-9]{26}$[]
Number of times to run each test case
1 <= x <= 1003
Number of simulations to run concurrently
1 <= x <= 505
Number of test cases to randomly sample (0 = use all)
x >= 00
Random seed for reproducible sub-sampling
null
Optional test cases to run from the selected test sets
1 - 100 elementsCustom metadata for tracking
{ "customer": { "campaign_id": "q4_2025" } }
Tags to associate with this run template. Null or omitted creates the run template with no tags. Pass [] for an empty tag list.
["nightly"]
Response
Run template created successfully
Run template configuration resource.
Show child attributes
Show child attributes
Was this page helpful?