> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Semantic Layer permission object

> A single grant on a Semantic Layer catalog, folder, or document.

The shape of a grant on the Semantic Layer axis.

| Field              | Type                              | Notes                                |
| ------------------ | --------------------------------- | ------------------------------------ |
| `id`               | UUID                              |                                      |
| `permission_level` | `viewer` \| `editor` \| `manager` | The only mutable field.              |
| `user`             | UUID                              | Expandable.                          |
| `group`            | UUID                              | Expandable.                          |
| `catalog`          | UUID                              | The Semantic Layer root. Expandable. |
| `folder`           | UUID                              | Expandable.                          |
| `document`         | UUID                              | Expandable.                          |
| `granted_by`       | UUID                              | Expandable.                          |
| `created_at`       | datetime                          |                                      |
| `updated_at`       | datetime                          |                                      |

Exactly one of `user` / `group` is set, and exactly one of `catalog` / `folder` / `document`.

The three resources are the hierarchy the Semantic Layer shows in the app, coarsest first: a grant on `catalog` reaches everything, a grant on `folder` reaches the documents inside it. Ids come from [Read the Semantic Layer](/platform-api/permissions/semantic-layer/resources).