---
title: "Update Evaluation"
method: PUT
path: "/api/v1/evaluations/{evaluation_id}"
tags: ["evals"]
---

# Update Evaluation

`PUT /api/v1/evaluations/{evaluation_id}`

Update an existing evaluation

## Path parameters

- `evaluation_id` string, required

## Request body

- UpdateEvaluationRequest — Request to update an existing evaluation
  - `name` string, nullable — Name of the evaluation
  - `description` string, nullable — Description of the evaluation
  - `tags` string[], nullable — Tags for categorization
  - `metadata` object, nullable — Additional metadata
  - `metrics` object, nullable — High-level metrics summary
  - `model_name` string, nullable — Model name
  - `dataset` string, nullable — Dataset name
  - `framework` string, nullable — Framework used
  - `task_type` string, nullable — Type of task
  - `inference_model` string, nullable — Prime Inference model ID
  - `eval_config` HostedEvalConfig — Hosted evaluation configuration
    - `num_examples` integer, required — Number of examples to evaluate (-1 for all)
    - `rollouts_per_example` integer, required — Rollouts per example
    - `env_args` object, nullable — Optional environment arguments to pass to the evaluation
    - `allow_sandbox_access` boolean, nullable — Allow sandbox read/write access
    - `allow_instances_access` boolean, nullable — Allow instance creation and management access
    - `allow_tunnel_access` boolean, nullable — Allow tunnel creation and management access
    - `timeout_minutes` integer, nullable — Custom timeout in minutes for the hosted eval run. Defaults to 1440. Use any negative value for no sandbox lifetime deadline. Finite values must be between 60 and 5256000.
    - `custom_secrets` object, nullable — Custom secrets to set in the evaluation sandbox (e.g., API keys, tokens)
    - `sampling_args` object, nullable — Optional sampling arguments forwarded to `prime eval run --sampling-args`
    - `max_concurrent` integer, nullable — Optional max concurrency forwarded to `prime eval run --max-concurrent`
    - `auto_max_concurrent` boolean — Whether max_concurrent was computed from hosted eval runtime resources
    - `max_retries` integer, nullable — Optional max retries forwarded to `prime eval run --max-retries`
    - `state_columns` string[], nullable — Optional state columns forwarded to `prime eval run --state-columns`
    - `independent_scoring` boolean, nullable — Forward `--independent-scoring` to the hosted eval runner
    - `verbose` boolean, nullable — Forward `--verbose` to the hosted eval runner
    - `headers` string[], nullable — Optional repeated headers forwarded to `prime eval run --header`
    - `extra_env_kwargs` object, nullable — Optional environment constructor kwargs forwarded to `prime eval run --extra-env-kwargs`
    - `api_client_type` string, nullable — Optional API client type forwarded to `prime eval run --api-client-type`
    - `api_base_url` string, nullable — Optional inference base URL forwarded to `prime eval run --api-base-url`
    - `api_key_var` string, nullable — Optional API key env var forwarded to `prime eval run --api-key-var`
  - `is_public` boolean, nullable — Whether the evaluation is publicly shareable by link; setting true without show_on_leaderboard keeps it off leaderboards by default
  - `show_on_leaderboard` boolean, nullable — Whether this public evaluation appears on environment leaderboards

## Response `200`

Successful Response

- UpdateEvaluationResponse — Response after updating an evaluation
  - `evaluation_id` string, required
  - `name` string, required
  - `status` 'PENDING' | 'RUNNING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT' | 'CANCELLED', required — Evaluation status enum
  - `updated_at` string, date-time, required

## Other responses

- `401` — Authorization failed
- `422` — Invalid request data

---

[API](https://skmtc.net/primeintellect/apis/pi-api.md) · [All operations](https://skmtc.net/primeintellect/apis/pi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/primeintellect/pi-api/versions/60efc9b3ff2a/schema)