v25

latestOpenAPI 3.1.0raw.githubusercontent.com2025-11-204973358.2 KB
Eval Runs

Get Eval Run

Retrieve a specific eval run by its UUID.

Args: eval_run_uuid (str): UUID of the eval run to retrieve. workspace_uuid (str, optional): UUID of the workspace. Defaults to None.

Returns: EvalRunResult: The eval run data.

Raises: AymaraAPIError: If the organization is missing or the eval run is not found.

Example: GET /api/eval-runs/{eval_run_uuid}

get/v2/eval-runs/{eval_run_uuid}

Path parameters

eval_run_uuidstring required

Query parameters

workspace_uuidstring

Response

OK

eval_run_uuidstring required

Unique identifier for the eval run.

eval_uuidstring required

Unique identifier for the eval.

namestring nullable

Name of the eval run, if any (defaults to the eval name + timestamp).

status'created' | 'processing' | 'finished' | 'failed' required

Resource status.

created_atstring date-time required

Timestamp when the eval run was created.

updated_atstring date-time required

Timestamp when the eval run was last updated.

ai_descriptionstring nullable

Description of the AI for this run, if any.

is_sandboxboolean

Indicates if the eval run is sandboxed (default: False).

workspace_uuidstring nullable

UUID of the associated workspace, if any.

pass_ratenumber nullable

Pass rate for the eval run, if any.

num_promptsinteger nullable

Number of prompts in the eval run, if any.

num_responses_scoredinteger nullable

Number of responses scored in the eval run, if any.