Update Column

Update a column’s title, config, or dependencies. Returns requires_recalculation: true when the change invalidates existing cell values.

PATCH /api/public/v2/tables/{table_id}/sheets/{sheet_id}/columns/{column_id}

Update Column

cURL

curl --request PATCH \
  --url https://api.promptlayer.com/api/public/v2/tables/{table_id}/sheets/{sheet_id}/columns/{column_id} \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "title": "<string>",
  "config": {},
  "dependencies": [
    {
      "column_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "reference_type": "value",
      "config_key": "<string>",
      "config_meta": {}
    }
  ]
}
'

200

{
  "success": true,
  "column": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "sheet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "workspace_id": 123,
    "title": "<string>",
    "config": {},
    "position_rank": 123,
    "is_output_column": true
  },
  "requires_recalculation": true,
  "affected_column_ids": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ],
  "version": 123
}

Update a column’s title, config, or dependencies.

When the change invalidates existing cell values (e.g., the prompt template or code changes), the response includes requires_recalculation: true and the list of affected_column_ids.

Authorizations

X-API-KEY · string · header · required

Path Parameters

table_id · string<uuid> · required

sheet_id · string<uuid> · required

column_id · string<uuid> · required

Body

application/json

title · string | null

config · object

dependencies · object[] | null

Show child attributes

Response

200

application/json

Column updated

success · boolean

column · object

A column within a Smart Table sheet.

Show child attributes

requires_recalculation · boolean

affected_column_ids · string<uuid>[]

version · integer