Rename column
curl --request PATCH \
--url https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}const url = 'https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}';
const options = {method: 'PATCH'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}"
response = requests.patch(url)
print(response.text)Rename column
Rename a column. Rate limit: 10 write requests per minute per workspace, one write at a time per workspace, plus 60 requests per minute per API key. 100 column changes per UTC day per workspace.
PATCH
/
v1
/
tables
/
{table_id}
/
columns
/
{column_id}
Rename column
curl --request PATCH \
--url https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}const url = 'https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}';
const options = {method: 'PATCH'};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://api.airscale.io/v1/tables/{table_id}/columns/{column_id}"
response = requests.patch(url)
print(response.text)Changes the label of any column, including read-only ones. The column
See limits, retries and error codes for shared behavior.
id and its values do not change, so integrations keyed by column ID keep working.
The new label must be unique within the table, ignoring case. Renaming a column to its current label succeeds without changing anything.
Paid plans only. No credits are charged. Limits: 10 write requests per minute per workspace, one write at a time per workspace, plus 60 requests per minute per API key. 100 column changes per UTC day per workspace. See the Tables API overview for every limit.
Authentication
SendAuthorization: Bearer $AIRSCALE_API_KEY. The key determines the workspace. See Authentication.
Parameters
| Name | Location | Required | Description |
|---|---|---|---|
table_id | path | Yes | Table ID returned by Create table or List tables. |
column_id | path | Yes | Column ID from the table’s columns. |
JSON body
| Field | Type | Required | Description |
|---|---|---|---|
label | string | Yes | New label, unique within the table, ignoring case. 1–200 characters. |
Request example
Replace path variables with IDs returned by the API. Column UUIDs in the example body must belong to your table.curl --request PATCH "https://api.airscale.io/v1/tables/$TABLE_ID/columns/$COLUMN_ID" \
--header "Authorization: Bearer $AIRSCALE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"label": "Mobile phone"
}'
Response
200
The renamed column.{
"column": {
"id": "bc629d4d-cc75-4cee-b10a-851203d82fac",
"label": "Mobile phone",
"type": "phone",
"fieldKey": "phone"
}
}
Errors
| Status | Meaning |
|---|---|
| 400 | Invalid body or ID. |
| 401 | Missing or invalid API key. |
| 403 | The workspace does not have an active paid plan. |
| 404 | Table or column not found in this workspace, or deleted. |
| 409 | Another column already has this label. |
| 429 | A rate limit, the one-write-at-a-time rule or a daily limit was reached. Wait for Retry-After before retrying. |
| 502 | The service could not be reached. Retry with backoff. |
| 503 | The service is at capacity or temporarily unavailable. Retry after Retry-After. |
| 504 | The request timed out after 30 seconds. A write may still have been applied; check the result before retrying it. |