Get Scenario

Retrieves a scenario by ID, including its graph, prompts, and dataset row count.

GET https://api.futureagi.com/simulate/scenarios/{scenario_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

scenario_id UUID Required

The scenario ID.

Response

200 OK
id string
UUID of the scenario.
name string
Scenario name.
description string
Scenario description.
source string
Data source used to create the scenario.
scenario_type string
Type: dataset, script, or graph.
dataset_id string
UUID of the underlying dataset. null if none.
agent_type string
Agent type: voice or text.
status string
Status: processing, completed, or failed.
graph object
Conversation graph structure. {} if none.
prompts array
Simulator agent prompts.
role string
Prompt role (e.g., "system").
content string
Prompt text.
dataset_rows integer
Number of test case rows.
created_at datetime
ISO 8601 creation timestamp.
updated_at datetime
ISO 8601 last-modified timestamp.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Scenario not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE