Update field

Rename a field, change its options (such as adding a choice) or move it. A field’s type can’t change; create a new field instead.

PATCH/v1/w/{workspace}/fields/{fieldId}

Send an Idempotency-Key. This may answer 202 while it waits for approval.

Path parameters

workspacestringrequired

Your workspace’s address name.

fieldIdstringrequired

The field, from Get table.

Headers

Idempotency-Keystring

8–100 characters. Repeat the same key and body to get the first outcome back instead of writing twice.

Body

namestring

A new name.

optionsobject

New settings for its type. Send the whole set, such as every choice.

positionnumber

Where it sits among the table’s fields.

Response

fieldobjectrequired

Details

Change a field name, options or position. The type cannot change.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X PATCH "https://api.olamma.sh/v1/w/your-workspace/fields/{fieldId}" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Order status"
  }'

Response 200

{
  "field": {
    "id": "<string>",
    "tableId": "<string>",
    "name": "<string>",
    "type": "<string>",
    "options": {},
    "position": 123
  }
}