FruxonDocs
ApiEvaluation runs

List all evaluation runs for an agent.

Returns the agent's evaluation runs newest-first, with cursor pagination. Use the candidateRevision, deployedRevision, and status filters to narrow the list — for example, repeat status to poll only PENDING and IN_PROGRESS runs while an evaluation is in flight.

GET
/v1/tenants/{tenant}/agents/{agent}/evaluationRuns

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The unique identifier of the agent

tenant*string

The tenant identifier

Query Parameters

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.

candidateRevision?integer

Filter by candidate revision number.

Formatint64
deployedRevision?integer

Filter by deployed revision number.

Formatint64
status?array<EvaluationRunStatus>

Filter by run status. Repeat the parameter to match multiple statuses (e.g. ?status=PENDING&status=IN_PROGRESS to poll only in-flight runs).

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/evaluationRuns"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "datasetId": "00000000-0000-0000-0000-000000000000",
      "candidateRevision": 0,
      "candidateBaseRevision": 0,
      "candidateSnapshotSeqNo": 0,
      "deployedRevision": 0,
      "status": "PENDING",
      "score": 0,
      "deploymentRecommendation": "string",
      "summary": {
        "totalSamples": 0,
        "successfulEvaluations": 0,
        "failedEvaluations": 0,
        "averageLlmScore": 0,
        "scoreDistribution": {},
        "assessmentDistribution": {},
        "topConcerns": [],
        "keyImprovements": [],
        "runtime": null,
        "cost": null
      },
      "errorMessage": "string",
      "createdAt": 0,
      "modifiedAt": 0,
      "startedAt": 0,
      "completedAt": 0,
      "createdBy": "string"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}