Skip to main content
PATCH
cURL
permission_level is the only writable field. Everything else on the object — the recipient, the resource, granted_by — is fixed at assignment time. To move a grant to a different resource or recipient, revoke it and assign a new one.
Assign Permissions can do the same thing in bulk and without knowing the grant id — it matches on recipient and resource. Use this endpoint when you already hold the id, for example from List Permissions.

Who can call it

An API key created by an Owner or Admin can change any grant. A key created by a Member can only move a grant between viewer and editor, and only on a resource where that Member holds manager. Anything else returns 403.

Authorizations

x-api-key
string
header
required

API Key authentication. Format: 'x-api-key: api_key'

Path Parameters

id
string<uuid>
required

A UUID string identifying this Lakehouse permission.

Body

permission_level
enum<string>
  • manager - Manager
  • editor - Editor
  • viewer - Viewer
Available options:
manager,
editor,
viewer

Response

200 - application/json
id
string<uuid>
required
read-only
permission_level
enum<string>
required
  • manager - Manager
  • editor - Editor
  • viewer - Viewer
Available options:
manager,
editor,
viewer
created_at
string<date-time>
required
read-only
updated_at
string<date-time>
required
read-only
user
string
required
read-only

User (Expandable)

group
string
required
read-only

Group (Expandable)

layer
string
required
read-only

Layer (Expandable)

folder
string
required
read-only

Folder (Expandable)

table
string
required
read-only

Table (Expandable)

volume
string
required
read-only

Volume (Expandable)

granted_by
string
required
read-only

Granted by (Expandable)