v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-011060456.0 KB

Permissions

List project permissions

Query and filter the permission with user_id and permission_id. (user_id, permission_id) together uniquely identify a permission.

get/project-permissions

Query parameters

user_idstring

Filter with the user ID. If set, only the permissions this user has will be returned. Client request must set user_id=me

Example:me

Filter with the user ID. If set, only the permissions this user has will be returned. Client request must set user_id=me

permission_idstring

Filter with the permission ID. If set, only the permissions with this specific ID will be returned

Example:16399452-c4f3-4554-8e44-c2d67bb60360

Filter with the permission ID. If set, only the permissions with this specific ID will be returned

recursive'true' | 'false'

Whether to list permissions recursively. If set to false, only the permission the users directly have will be listed. If set to true all the direct and indirect permissions will be listed.

Example:true

Whether to list permissions recursively. If set to false, only the permission the users directly have will be listed. If set to true all the direct and indirect permissions will be listed.

Response

Successful response

Example response

{
  "items": [
    {
      "id": "read_secret_info",
      "user_id": "3241a285-8329-4d69-8f3d-316e08cf140c"
    }
  ],
  "pagination": {
    "next_cursor": "b3d396b8-c574-4c80-97b3-50031675ceb2"
  }
}