---
title: "Get Eval Prompts"
method: GET
path: "/v2/evals/{eval_uuid}/prompts"
tags: ["Evals"]
---

# Get Eval Prompts

`GET /v2/evals/{eval_uuid}/prompts`

Retrieve prompts for a specific eval if they exist.

Args:
    eval_uuid (str): UUID of the eval to get prompts for.
    workspace_uuid (str, optional): Optional workspace UUID for filtering.

Returns:
    list[EvalPrompt]: List of prompts and metadata for the eval.

Raises:
    AymaraAPIError: If the eval is not found.

Example:
    GET /api/evals/{eval_uuid}/prompts

## Path parameters

- `eval_uuid` string, required

## Query parameters

- `workspace_uuid` string
- `limit` integer
- `offset` integer

## Response `200`

OK

- PagedEvalPrompt
  - `items` EvalPrompt[], required
    - `prompt_uuid` string, required — Unique identifier for the prompt.
    - `thread_uuid` string, nullable — Unique identifier for the thread, if any.
    - `turn_number` integer — Turn number in the conversation (default: 1).
    - `content` string, required — Content of the prompt.
    - `category` string, nullable — Category of the prompt, if any.
  - `count` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/aymara-ai/apis/aymara-api.md) · [All operations](https://skmtc.net/aymara-ai/apis/aymara-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aymara-ai/aymara-api/versions/0cb64ef11adf/schema)