Skip to main content
GET
Get Disposition Test Run

Overview

Dispositions are enabled per organization. If your organization does not have access, these endpoints return 404.
Returns one test run with its frozen definition, status, and counts. While the run is running, completedSize and failedSize are counted live from the per-call rows; once it finishes they are the final tally. Poll this endpoint after Create Disposition Test Run, then read results with Get Test Run Rows or Export Test Run CSV.

Headers

string
required
Your API key for authentication.

Path Parameters

string
required
The agent’s unique identifier. Must be a UUID; otherwise returns 400 with the message agentId must be a valid UUID. Returns 404 Agent not found if the agent is not in your organization.
string
required
The disposition’s unique identifier. Must be a UUID; otherwise returns 400 with the message dispositionId must be a valid UUID. Returns 404 Disposition not found if it does not belong to this agent.
string
required
The test run’s unique identifier. Must be a UUID; otherwise returns 400 with the message runId must be a valid UUID. Returns 404 Test run not found if it does not belong to this disposition.

Response

object
The test run.
null | array
null on success, or a list of error objects if the request failed.

Docs for agents: llms.txt