Skip to main content
GET
List Eval Agents

Headers

string
required
Your API key for authentication.

Query Parameters

integer
default:"25"
Number of results to return. Between 1 and 100.
string
Cursor: return results after this object ID.
string
Cursor: return results before this object ID. Cannot be combined with starting_after.

Response

string
Always "list".
array of objects
The list of eval agents. Each item contains the fields below.
string
Unique identifier for the eval agent.
string
Display name of the eval agent.
string | null
Optional description of what the eval agent grades.
string
ID of the current editable draft version.
string | null
ID of the published version experiments run against, or null if never published.
integer | null
Version number of the published version, or null if never published.
boolean
Whether the eval agent is enabled.
string
The modality of the eval agent. One of text or audio.
object | null
Summary of the most recent run against this agent, or null if no runs exist.
  • id - Run ID.
  • status - Status of the run.
  • created_at - ISO 8601 timestamp.
  • call_count - Number of calls evaluated.
  • target_hit_count - Number of calls that hit a target level.
  • graded_count - Number of calls that received a grade.
object
Key-value metadata associated with the eval agent. Values are strings.
string
ISO 8601 timestamp for when the eval agent was created.
string
ISO 8601 timestamp for when the eval agent was last updated.
boolean
Whether more results exist beyond this page.
string | null
Cursor to pass as starting_after to fetch the next page, or null if there are no more results.