List Agent Tests

GET

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

GET

/v1/agents/:id/tests

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

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

List all tests configured for the agent. Each entry includes the most recent run so the console can render pass/fail badges without an extra round-trip.

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired

Response

Tests for the agent with last-run summaries.

testslist of objects

Errors

401

Unauthorized Error

404

Not Found Error