v2

latestOpenAPI 3.0.32026-07-261513102.9 KB

Role Management

List role permission options

Lists the valid resource_id and access_type values that can be used when creating or updating Enterprise custom roles.

get/v1/roles/permissions

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.

Response

Successfully retrieved role permission options

resource_idsstring[] required

access_typesstring[] required

Example response

{
  "resource_ids": [
    "repository_management",
    "user_management",
    "role_management"
  ],
  "access_types": [
    "read",
    "write",
    "delete"
  ]
}