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

# Insights overview

> Score conversations against criteria you define, so agent quality becomes a number you can track over time instead of a sample you skim.

An evaluation is a set of criteria you define and then run against
conversations that already happened. It turns "is the agent doing a good job"
into a score you can watch over time, rather than a handful of transcripts
somebody read on a Friday.

## Endpoints

### Evaluation

| Endpoint                                                                                                       | Description                         |
| -------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| <Badge color="green" size="sm">GET</Badge> [List evaluations](/api-reference/evaluation/list-evaluations)      | List all evaluations by project ID. |
| <Badge color="blue" size="sm">POST</Badge> [Create evaluation](/api-reference/evaluation/create-evaluation)    | Create a new evaluation.            |
| <Badge color="green" size="sm">GET</Badge> [Get evaluation](/api-reference/evaluation/get-evaluation)          | Get an evaluation by ID.            |
| <Badge color="orange" size="sm">PATCH</Badge> [Update evaluation](/api-reference/evaluation/update-evaluation) | Update an evaluation by ID.         |
| <Badge color="red" size="sm">DELETE</Badge> [Delete evaluation](/api-reference/evaluation/delete-evaluation)   | Delete an evaluation by ID.         |
| <Badge color="blue" size="sm">POST</Badge> [Run evaluation](/api-reference/evaluation/run-evaluation)          | Run an evaluation.                  |
