COcoderabbit
Role Management

Create a custom role

Changed on

Creates an Enterprise custom role. If is_default is true, the new role becomes the subscription default and the previous default is cleared.

post/v1/roles

Request

  • Base URL
    https://api.coderabbit.ai
  • Auth
    API key in header x-coderabbitai-api-key

Request body

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.

namestring required
descriptionstring
is_defaultboolean
duplicate_fromstring

Role ID to copy permissions from. Defaults to cr_member when permissions are omitted.

Example request

{
  "name": "Security Reviewer",
  "permissions": [
    {
      "resource_id": "user_management"
    }
  ]
}

Response

Custom role created

Changes