Add AI Rows to Scenario | Future AGI Docs

POST https://api.futureagi.com/simulate/scenarios/{scenario_id}/add-rows/

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. The scenario must have an associated dataset.

num_rows integer Required

Number of rows to generate. Range: 10–20000.

description string Optional

Guidance for AI row generation. If omitted, existing rows and columns are used as context.

202 Accepted

message string

Confirmation that row generation has started.

scenario_id string

UUID of the scenario.

dataset_id string

UUID of the underlying dataset.

num_rows integer

Number of rows being generated.

400 Bad Request Optional

Invalid request or scenario state. The response includes an error message.

{"error": "Scenario does not have an associated dataset."}

Or for validation failures:

{
  "error": "…",
  "details": {
    "num_rows": ["Number of rows must be at least 10."]
  }
}

Common causes: no associated dataset, num_rows below 10 or above 20000.

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 add rows: <message>"}