---
title: "Get folder permissions"
method: GET
path: "/v1/folders/{folderId}/permissions"
tags: ["Folder permissions"]
---

# Get folder permissions

`GET /v1/folders/{folderId}/permissions`

Retrieve folder permissions for a user

## Path parameters

- `folderId` string, uuid, required

## Query parameters

- `userId` string, uuid, required

## Response `200`

Folder permissions object

- object
  - `permits` FolderPermission[]
    - `id` string — The ID of the user or user group.
    - `name` string — The name of the user or user group.
    - `description` string — Description of the permission source.
    - `type` 'user' | 'userGroup' — The type of the permission holder.
    - `direct` object — Direct permission details for this folder.
      - `accessBoost` boolean — If `true`, [AccessBoost](/share#boosting-permissions-with-accessboost) is enabled for the user.
      - `isOwner` boolean — If `true`, the user is the owner of the folder.
      - `role` 'NO_ACCESS' | 'VIEWER' | 'EDITOR' | 'MANAGER' — The content role associated with the user.

## Other responses

- `400` — Bad Request Possible error messages: - `userId: userId must be provided` - `userId: Invalid userId`
- `403` — Forbidden Possible error messages: - `User does not have permission to manage folder permissions` - The user sending the API request must have **Manager** permissions for the folder.
- `404` — Not Found Possible error messages: - `Folder with identifier "<folderId>" not found`
- `429` — Too Many Requests - Rate limit exceeded (60 requests/minute)

---

[API](https://skmtc.net/omni/apis/omni-api.md) · [All operations](https://skmtc.net/omni/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omni/omni-api/revisions/6b02f7349d0e/schema)