Get prompt simulation details

Retrieves a specific prompt simulation run.

GET https://api.futureagi.com/simulate/prompt-templates/{prompt_template_id}/simulations/{run_test_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

prompt_template_id UUID Required

UUID of the prompt template that owns this simulation run.

run_test_id UUID Required

UUID of the simulation run to retrieve.

Response

200 OK
id string

UUID of the simulation run.

name string

Name of the simulation run.

description string

Description of the simulation run, or null.

source_type string

Internal source type identifier (e.g., "prompt").

source_type_display string

Display label for the source type (e.g., "Prompt").

prompt_template string

UUID of the parent prompt template.

prompt_template_detail object

Parent prompt template object with id, name, description, and variable_names.

prompt_version string

UUID of the prompt version used by this simulation run.

prompt_version_detail object

Prompt version object with id, template_version, is_default, and commit_message.

scenarios array of string

Scenario UUIDs associated with this simulation run.

scenarios_detail array of object

Detailed scenario objects for each associated scenario.

dataset_row_ids array of string

Dataset row UUIDs included in this simulation. Empty array means all rows.

simulate_eval_configs array of string

Evaluation configuration UUIDs attached to this run.

simulate_eval_configs_detail array of object

Detailed evaluation configuration objects.

enable_tool_evaluation boolean

Whether tool usage evaluation is enabled.

created_at string

ISO 8601 creation timestamp.

updated_at string

ISO 8601 last-modified timestamp.

last_run_at string

ISO 8601 timestamp of last execution, or null.

Errors

401 Unauthorized Optional

Invalid or missing authentication credentials.

404 Not Found Optional

The specified prompt template or simulation run does not exist.

500 Internal Server Error Optional

An unexpected server error occurred.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE