Sign in

v2

latestOpenAPI 3.1.02026-07-26143251806.6 KB
smart-tables

Create Column

Add a new column to a sheet. Non-text columns will generate cells for all existing rows. Requests are scoped to the workspace associated with the API key; table, sheet, column, cell, operation, and version IDs must belong to that workspace.

post/api/public/v2/tables/{table_id}/sheets/{sheet_id}/columns

Path parameters

table_idstring uuid required
sheet_idstring uuid required

Request body

titlestring required
type'TEXT' | 'ABSOLUTE_NUMERIC_DISTANCE' | 'AI_DATA_EXTRACTION' | 'APPLY_DIFF' | 'ASSERT_VALID' | 'COALESCE' | 'CONDITION' | 'CODE_EXECUTION' | 'COMBINE_COLUMNS' | 'COMPARE' | 'COMPOSITION' | 'CONTAINS' | 'CONVERSATION_SIMULATOR' | 'COSINE_SIMILARITY' | 'COUNT' | 'ENDPOINT' | 'FOR_LOOP' | 'HUMAN' | 'JSON_PATH' | 'LLM_ASSERTION' | 'MATH_OPERATOR' | 'MCP' | 'MIN_MAX' | 'PARSE_VALUE' | 'PROMPT_TEMPLATE' | 'REGEX' | 'REGEX_EXTRACTION' | 'VARIABLE' | 'WHILE_LOOP' | 'WORKFLOW' | 'XML_PATH' required

Smart Table column type. Use uppercase backend enum values. Input: TEXT. Reference (Tables only, not in legacy evaluation/workflow enums): COMPOSITION. Computed: all other listed values. Create requests also accept lowercase aliases (text, prompt_template, llm, code, score, comparison, composition), which are normalized to uppercase. Legacy DATASET columns are not creatable.

configobject nullable

Type-specific column configuration.

Response

Column created

successboolean
versioninteger

Current sheet version_count for this response. It matches the sheet's version_count after any committed changes.