Add Columns to Scenario

Add up to 10 AI-generated columns to a scenario dataset. Specify name, data type, and description per column. Generation is asynchronous; returns 202 Accepted.

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 dataset must have at least one row.

Request body

columns array of object Required

Column definitions to add (1—10 per request). Names must be unique in the dataset. Each column: name (string, max 50 chars), dataType (text, boolean, integer, float, json, array, image, images, datetime, audio, document, others, persona), description (string, max 200 chars, guides AI generation).

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
Names of the columns being generated.

Errors

400 Bad Request Optional

Invalid columns: missing fields, duplicates, exceeds 10-column limit, or dataset has no rows.

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