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

# List available permissions

`GET /org/permissions`

## Request

- Base URL: `https://apiv2.senso.ai/api/v1`
- URL: `https://apiv2.senso.ai/api/v1/org/permissions`
- Auth: API key in header `X-API-Key`

Returns the permission actions offered for building org roles. The set is curated — a few platform-internal permissions are not listed here.

## Response `200`

The available permissions.

- AvailablePermissionsResponse: The permissions available for building roles.
  - `permissions` PermissionInfo[], required
    - `key` string, required: The permission key (e.g. `update:org`), as used in role definitions.
    - `name` string, required: Human-readable permission name.
    - `description` string, required: What the permission grants.
    - `category` string, required: Grouping the permission belongs to.

## Other responses

- `401`: Missing or invalid credentials — supply a valid org API key in the `X-API-Key` header.

---

[API](https://skmtc.dev/senso/apis/senso-org-api.md) - [All operations](https://skmtc.dev/senso/apis/senso-org-api/llms.txt) - [OpenAPI document](https://skmtc.dev/senso/apis/senso-org-api/revisions/d789b4fcbe84?raw)