Skip to main content
GET
/
v1
/
orgs
/
{org_id}
/
roles
/
permissions
/
metadata
Get Permissions Metadata
curl --request GET \
  --url https://api.letpiper.com/v1/orgs/{org_id}/roles/permissions/metadata \
  --header 'Authorization: Bearer <token>'
{
  "categories": [
    {
      "key": "<string>",
      "label": "<string>",
      "permissions": [
        {
          "value": "<string>",
          "label": "<string>"
        }
      ]
    }
  ],
  "role_presets": [
    {
      "key": "<string>",
      "label": "<string>",
      "description": "<string>",
      "permissions": [
        "<string>"
      ]
    }
  ]
}

Authorizations

Authorization
string
header
required

Platform token (starts with pat_)

Path Parameters

org_id
string<uuid>
required

Response

Successful Response

Response schema for permission metadata including categories and role presets.

categories
PermissionCategory · object[]
required
role_presets
RolePreset · object[]
required