---
title: "Get Permissions"
method: GET
path: "/permissions"
tags: ["Custom Roles"]
---

# Get Permissions

`GET /permissions`

This endpoint will give you all of the permissions available to your organization. The permissions are categorized by section, and by subsection. The permissions available to your organization are based on the plans your organization subscribes to; and thus the features included in those plans.

## Query parameters

- `org_id` integer

## Response `200`

OK

- PermissionsGetSuccessResponse — Response when permissions are successfully retrieved
  - `sections` PermissionsSection[]
    - `name` string
    - `order` integer
    - `subsections` PermissionsSubsection[]
      - `name` string
      - `order` integer
      - `permissions` PermissionsPermission[]
        - `name` string — Permission internal name
        - `order` integer — Ordering value used by the UI
        - `feature` string — Feature flag or product feature that gates this permission
        - `depends_on` string, nullable — If present, identifies the permission(s) that must also be granted for a user to have this permission.
        - `disabled_for_roles` string[] — List of `api_id`s of roles for which this permission is disabled

## Other responses

- `401` — You are not authenticated
- `403` — You are not allowed to perform this action

---

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