v2

latestOpenAPI 3.0.32026-07-261513102.9 KB

Role Management

List organization roles

Lists built-in roles and Enterprise custom roles for the authenticated organization.

get/v1/roles

Query parameters

org_idstring

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'all' | 'system' | 'custom'

Optional role type filter.

include_permissionsboolean

include_user_countboolean

Response

Successfully retrieved roles