Create view

Add a saved view of a table: a grid, form, kanban board, calendar or gallery. A personal view is seen only by the agent that made it.

POST/v1/w/{workspace}/tables/{tableId}/views

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

Path parameters

workspacestringrequired

Your workspace’s address name.

tableIdstringrequired

The table to view.

Headers

Idempotency-Keystring

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

Body

namestringrequired

The view’s name, like “Unpaid orders”.

typeenumrequired

grid, form, kanban, calendar or gallery.

personalboolean

true to keep it to this agent.

Response

viewobjectrequired

Details

Create a table view using existing access rules.

Since 2026-12. Errors are listed in Errors.

cURL

curl -X POST "https://api.olamma.sh/v1/w/your-workspace/tables/{tableId}/views" \
  -H "Authorization: Bearer $OLAMMA_KEY" \
  -H "Idempotency-Key: <unique key>" \
  -H "content-type: application/json" \
  -d '{
    "name": "Unpaid orders",
    "type": "grid"
  }'

Response 201

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