> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Evaluations API

> Define agent evaluations, run them, and inspect results.

For API groups, see [Evaluations API](/docs/cloud/apis/evaluations).

## Runs

Start, list, inspect, cancel, and resume agent, task, and workflow runs, follow their events, answer their input requests, and find the runs that schedules, webhooks, and evaluations start.

### Triggers

Start runs from schedules, webhooks, and evaluations, and list the runs they started.

| Operation | Description |
| - | - |
| [`listEvalRuns`](/docs/cloud/graphql/operations/evaluations-api/queries/listevalruns) | List the runs of a project evaluation. |
| [`projectEvalRun`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevalrun) | Returns one evaluation run. |
| [`projectEvalRunReport`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevalrunreport) | Returns the report produced by an evaluation run when available. |
| [`projectEvalRuns`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevalruns) | Lists runs of an evaluation definition. |
| [`projectEvalRunsConnection`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevalrunsconnection) | Lists runs of an evaluation definition, one page at a time. |
| [`runProjectEval`](/docs/cloud/graphql/operations/evaluations-api/mutations/runprojecteval) | Starts a new run of a project evaluation definition. |

## Queries

| Operation | Description |
| - | - |
| [`projectEval`](/docs/cloud/graphql/operations/evaluations-api/queries/projecteval) | Returns a evaluation definition from the selected project source. |
| [`projectEvalDocument`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevaldocument) | Returns the evaluation source document and its editable fields. |
| [`projectEvals`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevals) | Lists evaluations from the selected project source. |
| [`projectEvalsDiscovery`](/docs/cloud/graphql/operations/evaluations-api/queries/projectevalsdiscovery) | Lists evaluations with source discovery diagnostics. |

## Mutations

| Operation | Description |
| - | - |
| [`createProjectEval`](/docs/cloud/graphql/operations/evaluations-api/mutations/createprojecteval) | Creates a evaluation definition in project source. |
| [`updateProjectEval`](/docs/cloud/graphql/operations/evaluations-api/mutations/updateprojecteval) | Updates supported fields in a project evaluation definition. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.