List test runs

Lists all test runs.

GET https://api.futureagi.com/simulate/run-tests/

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.

Query parameters

search string Optional

Case-insensitive partial match on test run name or agent definition name.

limit integer Optional

Number of records per page. Defaults to 10. Must be a positive integer.

page integer Optional

Page number to retrieve. Defaults to 1.

simulation_type string Optional

Filter by source type. Accepted values: agent_definition, prompt.

prompt_template_id string Optional

Filter by prompt template UUID.

Response

200 OK
count integer

Total number of matching test runs across all pages.

next string or null

URL to the next page, or null if on the last page.

previous string or null

URL to the previous page, or null if on the first page.

results array of objects

Array of test run objects for the current page.

id string

UUID of the test run.

name string

Display name of the test run.

description string

Description of the test run.

agent_definition string or null

UUID of the associated agent definition, or null if using a prompt template.

agent_definition_detail object or null

Expanded agent definition details, or null if none associated.

source_type string

Either agent_definition or prompt.

source_type_display string

Human-readable source type label.

scenarios array of string

Array of linked scenario UUIDs.

enable_tool_evaluation boolean

Whether tool evaluation is enabled.

created_at string

ISO 8601 creation timestamp.

updated_at string

ISO 8601 last-modified timestamp.

last_run_at string or null

ISO 8601 timestamp of the most recent execution, or null if never executed.

Errors

401 Unauthorized Optional

Missing or invalid X-Api-Key or X-Secret-Key headers.

500 Internal Server Error Optional

Unexpected server error. Contact support if it persists.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE