Get Eval Task

Retrieves a specific eval task by ID.

GET https://api.futureagi.com/tracer/eval-task/{id}/

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.

Path parameters

id UUID Required

The eval task ID.

Response

200 OK
id string
UUID of the eval task.
name string
Name of the eval task.
project string
UUID of the associated project.
status string
Current status: pending, running, completed, failed, paused, or deleted.
sampling_rate number
Percentage of spans being evaluated (1.0–100.0).
spans_limit integer
Max spans to evaluate. null for continuous tasks.
run_type string
Execution mode: continuous or historical.
evals array
List of custom eval config UUIDs attached to this task.
evals_details array
Expanded details for each attached eval config, including id and name.
id string
UUID of the eval config.
name string
Eval config name.
template object
Evaluation template info.
filters object
Query filters applied to eligible spans. Empty object means all spans.
failed_spans array
Span IDs that failed during evaluation.
start_time datetime
When the eval task began executing. null if not started.
end_time datetime
When the eval task finished. null for active tasks.
last_run datetime
Timestamp of the most recent evaluation cycle.
created_at datetime
When the eval task was created.
updated_at datetime
When the eval task was last modified.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

No eval task found with the specified ID.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE