Edit Scenario | Future AGI Docs

PUT https://api.futureagi.com/simulate/scenarios/{scenario_id}/edit/

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.

scenario_id UUID Required

The scenario ID.

name string Optional

Updated scenario name. Max 255 characters. Cannot be blank or whitespace-only.

description string Optional

Updated scenario description.

graph object Optional

Updated conversation graph structure. Replaces the active ScenarioGraph.graph_config.graph_data. If no active graph exists, a new one is created.

prompt string Optional

Updated simulator agent prompt text. Replaces the simulator_agent.prompt field.

200 OK

message string

Confirmation of successful update: "Scenario updated successfully".

scenario object

Updated scenario object (full ScenarioSchema — see List Scenarios for field reference).

400 Bad Request Optional

Validation error. The response includes an error message and a details object with per-field errors.

{
  "error": "…",
  "details": {
    "name": ["Name cannot be empty or just whitespace."]
  }
}

401 Unauthorized Optional

Invalid or missing API credentials.

404 Not Found Optional

Scenario not found or does not belong to your organization.

{"error": "Scenario not found."}

500 Internal Server Error Optional

Unexpected server error.

{"error": "Failed to update scenario: <message>"}