Add Columns to Scenario

Adds new AI-generated columns to a scenario's dataset. Returns 202 Accepted and runs asynchronously.

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

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. The scenario must have an associated dataset with at least one row.

Request body

columns array of object Required

Column definitions to add. Min 1, max 10 per request. Column names must be unique within the request and must not already exist in the dataset.

Each column object:

name string Required

Column name. Max 50 characters. Cannot be blank or whitespace-only. Must be unique within the request and not already present in the dataset.

data_type string Required

Column data type. One of: text, boolean, integer, float, json, array, image, images, datetime, audio, document, others, persona.

description string Required

Column description. Max 200 characters. Guides the AI when generating values.

Response

202 Accepted
message string
Confirmation that column generation has started.
scenario_id string
UUID of the scenario.
dataset_id string
UUID of the underlying dataset.
columns array of string
Names of the columns being generated.

Errors

400 Bad Request Optional

Invalid request or dataset state. The response includes an error message and (for field errors) a details object.

{
  "columns": "Column 'expected_outcome' already exists in the dataset."
}

Or:

{
  "columns": "Duplicate column name(s): difficulty_level"
}

Common causes:

  • No associated dataset
  • Dataset has no rows
  • Column name already exists in the dataset
  • Duplicate column names within the request
  • More than 10 columns submitted
  • Invalid data_type value
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 columns: <message>"}
GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE