Skip to main content
GET
/
v1
/
run-templates
List run templates
curl --request GET \
  --url https://api.coval.dev/v1/run-templates \
  --header 'X-API-Key: <api-key>'
{
  "run_templates": [
    {
      "name": "run-templates/abc123def456ghi789jklm",
      "id": "abc123def456ghi789jklm",
      "display_name": "Voice Agent Daily Test",
      "description": "Daily regression test for voice agent",
      "agent_id": "gk3jK9mPq2xRt5vW8yZaBc",
      "persona_id": "hL4kL0nQr3ySt6vX9zAcDd",
      "test_set_id": "aB1cD2eF",
      "metric_ids": [
        "iM5lM1oRs4zTu7wY0aBdEe"
      ],
      "mutation_ids": [],
      "iteration_count": 3,
      "concurrency": 5,
      "sub_sample_size": 0,
      "sub_sample_seed": null,
      "metadata": {
        "customer": {
          "campaign_id": "q4_2025"
        }
      },
      "create_time": "2025-10-14T12:00:00Z",
      "update_time": "2025-10-15T14:30:00Z"
    }
  ],
  "next_page_token": null,
  "total_count": 1
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

page_size
integer
default:50

Maximum number of results per page

Required range: 1 <= x <= 100
page_token
string

Opaque pagination token from previous response

Response

Run templates retrieved successfully

run_templates
object[]
required
next_page_token
string | null

Token for fetching next page (null if no more results)

Example:

"eyJvZmZzZXQiOjUwfQ=="

total_count
integer

Total count of templates matching filter

Example:

25