List Dataset Evals — API

List available evaluations for a dataset. Filter by name, category (built-in or user), type, or tags to find the right eval.

GET https://api.futureagi.com/model-hub/develops/{dataset_id}/get_evals_list/

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

dataset_id UUID Required

UUID of the dataset to retrieve evaluations for.

Query parameters

search_text string Optional

Text string to filter evaluations by name. Case-insensitive.

eval_categories string Optional

Filter by category. One of futureagi_built or user_built.

eval_type string Optional

Filter by type. One of preset, user, or previously_configured.

eval_tags[] array Optional

Array of tag strings to filter evaluations by.

use_cases[] array Optional

Array of use case strings to filter evaluations by.

experiment_id string Optional

UUID of an experiment to scope the results to.

order string Optional

Ordering mode. Use simulate for simulation-specific ordering.

Response

200 OK
data object
Response payload containing evaluations and recommendations.
evals array
Array of evaluation objects matching the specified filters.
id string
UUID of the evaluation.
name string
Name of the evaluation.
description string

Description of what the evaluation assesses.

eval_template_tags array

Tag strings associated with the evaluation template.

eval_recommendations array
Recommended evaluation category strings based on the dataset.
success boolean
Whether the request completed successfully.

Errors

400 Bad Request Optional
Invalid request parameters.
401 Unauthorized Optional
Invalid or missing API credentials.
404 Not Found Optional
The specified dataset does not exist.
500 Internal Server Error Optional
An unexpected error occurred on the server while fetching the evaluations list.
GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE