Generate a formula column from a description
Build a formula definition from a natural-language instruction. The generated chain is validated with the same reference and type derivation the save path uses, then returned UNSAVED for review — feed it to the preview endpoint or the create endpoint unchanged. A rejected attempt is retried once with the validation error fed back. A few sample rows are sent to the model as context. When the request asks for data the table’s columns do not hold, no formula is invented: the response is a 422 whose issue type is formula_not_supported and whose message explains what is missing.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
Request body for generating a formula definition from a description.
A natural-language description of the formula to build.
1 - 2000Response
Successful Response
A generated formula definition, validated but NOT saved.
The caller reviews it — the same definition shape the editor produces by hand, so it flows into the existing preview and create endpoints unchanged.
The data type the generated chain produces.
string, integer, float, boolean, datetime, date, list, dict Definition of a manual column: typed, user-editable cells.
- ManualColumnDefinition
- FormulaColumnDefinition
- EnrichmentColumnDefinition
- SourceColumnDefinition
- ExportColumnDefinition
- SequenceColumnDefinition
One sentence describing what the chain does.
A proposed column name. The editor adopts it when the user has not named the column, so a generated formula is savable without a second step.