---
title: "List Permissions"
method: GET
path: "/permissions"
tags: ["permissions", "Permissions"]
---

# List Permissions

`GET /permissions`

List Permissions

## Query parameters

- `cursor` string
- `per_page` integer
- `path` string
- `include_groups` boolean
- `group_id` string
- `partner_id` string
- `user_id` string

## Response `200`

A list of Permissions objects.

- PermissionEntity[]
  - `id` integer — Permission ID
  - `path` string — Path
  - `user_id` integer — User ID
  - `username` string — Username (if applicable)
  - `group_id` integer — Group ID
  - `group_name` string — Group name (if applicable)
  - `group_ids` integer[] — Group IDs when this permission requires multiple groups
  - `group_names` string[] — Group names when this permission requires multiple groups
  - `partner_id` integer — Partner ID (if applicable)
  - `partner_name` string — Partner name (if applicable)
  - `permission` 'full' | 'readonly' | 'writeonly' | 'list' | 'history' | 'admin' | 'bundle' | 'site_admin' | 'readonly_site_admin' | 'previewonly' — Permission type. See the table referenced in the documentation for an explanation of each permission.
  - `recursive` boolean — Recursive: does this permission apply to subfolders?
  - `site_id` integer — Site ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

[API](https://skmtc.net/files/apis/files-com-api.md) · [All operations](https://skmtc.net/files/apis/files-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/files/files-com-api/versions/c80c746637fd/schema)