Skip to main content
PATCH
/
api
/
public
/
v2
/
tables
/
{table_id}
/
sheets
/
{sheet_id}
/
columns
/
{column_id}
Update Column
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": {}
    }
  ]
}
'
{
  "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. When the update changes column metadata or configuration, PromptLayer creates a new sheet version and returns version.

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

Response

Column updated

​
success
boolean
​
column
object

A column within a Table sheet.

​
requires_recalculation
boolean
​
affected_column_ids
string<uuid>[]
​
version
integer

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