---
title: "List Permissions by user id"
method: GET
path: "/permissions"
tags: ["public_permissions", "public", "Permissions"]
---

# List Permissions by user id

`GET /permissions`

## Query parameters

- `userId` string, UUID
- `organizationId` string, UUID

## Response `200`

List Permissions.

- PermissionsResponse — List/Array of multiple permissions
  - `data` PermissionResponseRead[], required
    - `permissionId` string, uuid, required
    - `permissionType` 'instance_admin' | 'organization_admin' | 'organization_editor' | 'organization_runner' | 'organization_reader' | 'organization_member' | 'workspace_owner' | 'workspace_admin' | 'workspace_runner' | 'workspace_editor' | 'workspace_reader', required — Describes what actions/endpoints the permission entitles to
    - `userId` string, uuid, required — Internal Airbyte user ID
    - `scopeId` string, uuid, required
    - `scope` 'workspace' | 'organization' | 'none', required — Scope of a single permission, e.g. workspace, organization

## Other responses

- `403` — Not allowed
- `404` — Not found

## Changes

> 31 revisions in range; 1 could not be searched.

- **2024-10-23** `fae855ef1b76` — 2 warning
  - added the new `organization_runner` enum value to the `data/items/permissionType` response property for the response status `200`
  - added the new `workspace_runner` enum value to the `data/items/permissionType` response property for the response status `200`

[Change history](https://skmtc.dev/airbytehq/apis/airbyte-api/changes/permissions/get.md)

---

[API](https://skmtc.dev/airbytehq/apis/airbyte-api.md) · [All operations](https://skmtc.dev/airbytehq/apis/airbyte-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/airbytehq/airbyte-api/revisions/1ab9ff46c57a/schema)