List Agent Test Runs

GET

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

GET

/v1/agents/tests/:id/runs

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

1 {
2   "next_cursor": "string",
3   "has_more": true,
4   "runs": [
5     {
6       "id": "run_01kpvdq02cbtxqqsca60m5scng",
7       "test_id": "string",
8       "agent_id": "string",
9       "status": "queued",
10       "created_at": "2024-01-15T09:30:00Z",
11       "started_at": "2024-01-15T09:30:00Z",
12       "completed_at": "2024-01-15T09:30:00Z",
13       "result": {
14         "test_type": "reply",
15         "passed": true,
16         "rationale": "The agent greeted Alice by name as required.",
17         "duration_ms": 1240,
18         "reply": {
19           "agent_response": "Hi Alice! How can I help you today?",
20           "passed": true,
21           "rationale": "Response contains the caller's name.",
22           "score": 0.95,
23           "duration_ms": 1240
24         },
25         "tool_call": null,
26         "simulation": null
27       },
28       "error": "string"
29     }
30   ]
31 }

List one page of run history for a test, newest first. Paginate by passing cursor from the previous response.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Query parameters

cursorstringOptional

Opaque cursor from a prior response’s next_cursor.

limitintegerOptional1-200Defaults to 50

Page size. Defaults to 50; capped at 200.

Response

Run history for the test.

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.

runslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error