Skip to main content
GET
List organization roles
Lists built-in roles and Enterprise custom roles for the authenticated organization. Use the role_type query parameter to filter by role type, and include permissions or user_count in the response as needed. For more information, see Role-based access.

Authorizations

x-coderabbitai-api-key
string
header
required

API key for authentication. You can create an API key from the CodeRabbit dashboard.

Query Parameters

org_id
string

Required when authenticating with a workspace-scoped API token: the git-provider organization id to target within the token's workspace. Ignored for organization and self-hosted keys.

role_type
enum<string>
default:all

Optional role type filter.

Available options:
all,
system,
custom
include_permissions
boolean
default:false
include_user_count
boolean
default:true

Response

200

Successfully retrieved roles