List Scenarios

Returns a paginated list of scenarios with optional search and filtering.

GET https://api.futureagi.com/simulate/scenarios/

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 search against scenario name and source.

limit integer Optional

Results per page. Default: 10.

page integer Optional

Page number, starting from 1. Default: 1.

agent_definition_id string Optional

Filter by agent definition UUID.

agent_type string Optional

Filter by agent type: "voice" or "text".

Response

200 OK
count integer
Total matching scenarios.
next string
URL of the next page, or null.
previous string
URL of the previous page, or null.
results array
Array of scenario objects.
id string
UUID of the scenario.
name string
Scenario name.
description string
Scenario description.
source string
Data source.
scenario_type string
Scenario type.
scenario_type_display string
Display label for scenario type.
source_type string
Source type classification.
source_type_display string
Display label for source type.
dataset_rows integer
Number of test case rows.
agent_type string
Agent type: voice or text.
status string
Current status.
created_at datetime
ISO 8601 creation timestamp.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE