about), what that customer wants (customer_goal) and when the conversation counts as good (pass_if). Running it talks it through 3 times with the agent in test mode; last holds what came out of the latest run that included it.
Endpoint
Required scope
agents:read
Path parameters
Query parameters
Example request
curl
Response
200 OK
last is null for a test that never ran. Its verdict:
fixed is true when the test passes now and the run before was failing or flaky.
404 Not Found
AGENT_NOT_FOUND when the agent belongs to another project of the company, UPSTREAM_ERROR (message AGENT_NOT_FOUND) when no agent has that id in the company.
401 Unauthorized
Missing, invalid, revoked, or expired token.403 Forbidden
The token does not have theagents:read scope.
502 Bad Gateway
The agent service is unreachable.Operational notes
- The verdict is computed when you read, from the latest runs. Nothing is stored on the test itself.
- For the counts only, use
GET .../tests/summary.