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 pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

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",
      "kind": "DATASET",
      "datasetId": "00000000-0000-0000-0000-000000000000",
      "candidateRevision": 0,
      "candidateBaseRevision": 0,
      "candidateProposalId": "00000000-0000-0000-0000-000000000000",
      "candidateSnapshotSeqNo": 0,
      "deployedRevision": 0,
      "status": "PENDING",
      "score": 0,
      "deploymentRecommendation": "string",
      "summary": {
        "totalSamples": 0,
        "successfulEvaluations": 0,
        "failedEvaluations": 0,
        "averageLlmScore": 0,
        "scoreDistribution": {},
        "assessmentDistribution": {},
        "topConcerns": [],
        "keyImprovements": [],
        "pairwise": null,
        "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
}