Skip to main content
Lists the saved tests of an agent, oldest first. A test is a customer situation (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 the agents: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.