List Tests

GET

https://api.speechify.ai/v1/agents/tests

GET

/v1/agents/tests

$ curl https://api.speechify.ai/v1/agents/tests \
>      -H "Authorization: Bearer <token>"

1 {
2   "next_cursor": "string",
3   "has_more": true,
4   "tests": [
5     {
6       "agent_id": "string",
7       "config": {
8         "context": "The caller says: Hi, I'm Alice.",
9         "success_criteria": "The agent greets Alice by name.",
10         "success_examples": [
11           "Hi Alice! How can I help you today?"
12         ],
13         "failure_examples": [
14           "Hello! How can I help you?"
15         ]
16       },
17       "created_at": "2024-01-15T09:30:00Z",
18       "description": "string",
19       "id": "test_01ky612y9cb7dbaj638x46msxv",
20       "name": "string",
21       "type": "reply",
22       "updated_at": "2024-01-15T09:30:00Z",
23       "attached_agent_ids": [
24         "string"
25       ],
26       "folder_id": "string",
27       "last_run": {
28         "id": "run_01kpvdq02cbtxqqsca60m5scng",
29         "test_id": "string",
30         "agent_id": "string",
31         "status": "queued",
32         "created_at": "2024-01-15T09:30:00Z",
33         "started_at": "2024-01-15T09:30:00Z",
34         "completed_at": "2024-01-15T09:30:00Z",
35         "result": {
36           "test_type": "reply",
37           "passed": true,
38           "rationale": "The agent greeted Alice by name as required.",
39           "duration_ms": 1240,
40           "reply": {
41             "agent_response": "Hi Alice! How can I help you today?",
42             "passed": true,
43             "rationale": "Response contains the caller's name.",
44             "score": 0.95,
45             "duration_ms": 1240
46           },
47           "tool_call": null,
48           "simulation": null
49         },
50         "error": "string"
51       },
52       "tool_mock_config": {
53         "strategy": "selected",
54         "no_match_behavior": "call_real_tool",
55         "mocks": [
56           {
57             "tool_name": "get_account_balance",
58             "response": null
59           }
60         ]
61       },
62       "variables": {}
63     }
64   ]
65 }

Workspace-wide list of tests across every agent the caller owns. Supports filters (agent, type, last-run status, folder), full-text search on name/description, and cursor pagination. Each row carries its newest run and attached agent IDs so the list renders without N+1 round-trips. Walk pages while has_more is true.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Query parameters

agent_idstringOptional

Comma-separated agent IDs to filter on.

typestringOptional

Comma-separated test types (reply|tool|simulation).

statusstringOptional

Comma-separated last-run statuses.

folder_idstringOptional

Folder ID to filter on, or "root" for unfiled tests.

updated_afterstringOptional

Only return tests updated after this RFC3339 timestamp.

qstringOptional

Substring match on name or description.

limitintegerOptional

Max tests per page (default 50, max 200).

cursorstringOptional

Opaque pagination cursor from a previous response.

Response

Paginated list.

next_cursorstring or null

Opaque keyset cursor for the next page. Pass back as the cursor request parameter. null when the caller has reached the end of the list (has_more is also false in that case).

has_moreboolean

True when more rows exist beyond this page.

testslist of objects

Errors

401

Unauthorized Error