Sign in

v25

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

Create Eval Run

Create a new eval run for an eval.

Args: eval_run_data (EvalRunRequest): Data for the eval run to create. workspace_uuid (str, optional): UUID of the workspace. Defaults to None. is_sandbox (bool, optional): Whether to run in sandbox mode. Defaults to None.

Returns: EvalRunResult: The created eval run result.

Raises: AymaraAPIError: If the organization is missing or the request is invalid.

Example: POST /api/eval-runs { "eval_uuid": "...", ... }

post/v2/eval-runs

Query parameters

workspace_uuidstring
is_sandboxboolean nullable

Request body

eval_uuidstring required

Unique identifier for the eval.

eval_run_uuidstring nullable

Unique identifier for the eval run, if any.

namestring nullable

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

ai_descriptionstring nullable

Description of the AI for this run, if any.

continue_threadboolean nullable

Whether to continue the thread after this run.

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.