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

# request_eval

> Trigger a new evaluation run

# request\_eval

Trigger a new evaluation run for a specific prompt. The eval will be queued and picked up by the next available runner.

## Parameters

| Parameter     | Type   | Required | Description                       |
| ------------- | ------ | -------- | --------------------------------- |
| `promptId`    | string | Yes      | Prompt UUID (from `list_prompts`) |
| `description` | string | No       | Notes for this eval run           |

## Response

```json theme={null}
{
  "id": "uuid-here",
  "promptTitle": "Getting Started with Resend",
  "orgDomain": "resend.com",
  "status": "pending"
}
```

Eval runs typically take 5-15 minutes. Use `list_eval_requests` to track progress.