---
title: "Run experimental agent evals"
method: POST
path: "/api/agent/evals/run"
tags: ["Agent"]
---

# Run experimental agent evals

`POST /api/agent/evals/run`

## Request

- Base URL: `/api/plugins/consensys-asko11y-app/resources` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/plugins/consensys-asko11y-app/resources/api/agent/evals/run`
- Auth: one of:
  - API key in cookie `grafana_session`
  - HTTP bearer

## Request body

- AgentEvalRunRequest
  - `runId` string: Optional run ID to score. If omitted, recent runs for the current user/org are scored.
  - `limit` integer: Maximum recent runs to score when runId is omitted

## Response `200`

Eval run completed

- object
  - `status` 'completed', required
  - `results` AgentEvalResult[], required
    - `runId` string, required
    - `sessionId` string: Chat session that owns this agent run.
    - `status` 'running' | 'completed' | 'failed' | 'cancelled', required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `evidenceCount` integer, required
    - `approvalCount` integer, required
    - `unresolvedApprovalCount` integer, required
    - `finalReportPresent` boolean, required
    - `scores` AgentEvalScores, required
      - `evidenceCoverage` integer, required
      - `approvalCompliance` integer, required
      - `finalReportCompleteness` integer, required
      - `rcaQuality` integer, required
      - `hallucinationRisk` integer, required
      - `overall` integer, required
    - `warnings` string[]

## Other responses

- `403`: Forbidden (insufficient permissions or RBAC violation)
- `404`: Resource not found

## Changes

- **2026-06-01** `3ccc03eccaef`: 1 info
  - added the optional property `results/items/sessionId` to the response with the `200` status
- **2026-05-29** `642c928dd8e4`: 1 info
  - endpoint added
- **2026-02-18** `5e7e9a233e2d`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/changes/api/agent/evals/run/post.md)

---

[API](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api.md) - [All operations](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/consensys/apis/ask-o11y-ai-powered-observability-assistant-api/revisions/ee3ccd0f186d?raw)