table-columns

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.

post/tables/{table_id}/columns/generate/

Request

  • Base URL: https://api.getoneprofile.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.getoneprofile.ai/tables/{table_id}/columns/generate/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

table_idstring uuid required

Request body

instructionstring required

A natural-language description of the formula to build.

Response

Successful Response

data_type'string' | 'integer' | 'float' | 'boolean' | 'datetime' | 'date' | 'list' | 'dict' required

Type of a property. Used while creating/updating/deleting properties.

explanationstring required

One sentence describing what the chain does.

suggested_namestring required

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.

Changes

No recorded changes to this operation across all 1 revision of this API.