Update Eval Task

Partially updates an eval task's configuration.

PATCH https://api.futureagi.com/tracer/eval-task/update_eval_task/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Request body

Only included fields are updated. Omitted fields retain their current values.

eval_task_id string Required

UUID of the eval task. Must not be running or deleted.

edit_type string Required

Update mode. Values: "fresh_run" (clears all previous results), "edit_rerun" (preserves existing results, runs missing evals only).

name string Optional

Updated name. 1-255 characters.

evals array Optional

Updated list of custom eval config UUIDs. Replaces the existing list.

sampling_rate number Optional

Updated sampling percentage, between 1.0 and 100.0.

run_type string Optional

Updated execution mode. Values: "continuous", "historical".

spans_limit integer Optional

Updated max spans. Required for "historical" run type. Range: 1-1000000.

filters object Optional

Updated query filters. Pass null to clear.

Errors

400 Bad Request Optional

Invalid values, or task is currently running and must be paused first.

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

No eval task found with the specified ID.

GET /
Authentication
REQUEST
 
RESPONSE