Update view

Change a view’s name, sort, filters, columns or lock. Send the version you last read from Get table; if the view changed meanwhile, you get a conflict instead of overwriting someone’s change.

PATCH/v1/w/{workspace}/views/{viewId}

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

Path parameters

workspacestringrequired

Your workspace’s address name.

viewIdstringrequired

The view, 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

configobject

The view’s settings, such as sort and filters, in the same shape Get table returns.

positionnumber

lockedboolean

true to stop people changing it without manage access.

expectedVersionstringrequired

The view’s version from your last read.

Response

viewobjectrequired

Details

Change a saved view with its current expected version.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X PATCH "https://api.olamma.sh/v1/w/your-workspace/views/{viewId}" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Unpaid orders",
    "expectedVersion": "…",
    "config": {
      "sort": {
        "fieldId": "tf_due",
        "direction": "asc"
      }
    }
  }'

Response 200

{
  "view": {
    "id": "<string>",
    "tableId": "<string>",
    "name": "<string>",
    "type": "<string>",
    "config": {},
    "version": "<string>"
  }
}