curl --request POST \
--url https://api.coderabbit.ai/v1/users/roles \
--header 'Content-Type: application/json' \
--header 'x-coderabbitai-api-key: <api-key>' \
--data '
{
"role": "cr_admin",
"user_ids": [
"121358802",
"22605247"
]
}
'{
"status": "success",
"succeeded": [
"121358802",
"22605247"
],
"failed": []
}{
"error": {
"code": "BATCH_SIZE_EXCEEDED",
"message": "Maximum 500 users per request"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or inactive API key"
}
}{
"error": {
"code": "NOT_ADMIN",
"message": "Only administrators can perform seat management operations"
}
}{
"error": {
"code": "LEGACY_API_KEY",
"message": "You are using a legacy API key. We are deprecating use of legacy keys. Regenerate a new API key and retry the request."
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Max 10 requests per 60 seconds"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error while listing users"
}
}Roles
Bulk change roles for users in the organization. Supports up to 500 users per request. Cannot modify billing admin roles. Rate limited to 10 requests per 60 seconds with max 3 concurrent requests per organization. Requires user_management:write and an Enterprise plan.
curl --request POST \
--url https://api.coderabbit.ai/v1/users/roles \
--header 'Content-Type: application/json' \
--header 'x-coderabbitai-api-key: <api-key>' \
--data '
{
"role": "cr_admin",
"user_ids": [
"121358802",
"22605247"
]
}
'{
"status": "success",
"succeeded": [
"121358802",
"22605247"
],
"failed": []
}{
"error": {
"code": "BATCH_SIZE_EXCEEDED",
"message": "Maximum 500 users per request"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or inactive API key"
}
}{
"error": {
"code": "NOT_ADMIN",
"message": "Only administrators can perform seat management operations"
}
}{
"error": {
"code": "LEGACY_API_KEY",
"message": "You are using a legacy API key. We are deprecating use of legacy keys. Regenerate a new API key and retry the request."
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded. Max 10 requests per 60 seconds"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error while listing users"
}
}Authorizations
API key for authentication. You can create an API key from the CodeRabbit dashboard.
Headers
Your CodeRabbit API key
Body
Request to change user roles
Role ID to assign. Use cr_admin, cr_member, or a custom role UUID. cr_billing_admin cannot be assigned through this endpoint.
1Array of provider user IDs
1 - 500 elements1Required for workspace-scoped API keys: the provider organization ID within the workspace. For self-hosted instance keys, use a provider organization ID or ALL (case-insensitive) to apply the role change across active organizations on that instance. Omit it to preserve single-organization behavior for self-hosted keys. Organization keys remain bound to their own organization; ALL is valid only for self-hosted instance keys.
1Response
Operation completed (check status field for partial failures)
Response for bulk operations with partial success model
Operation status: 'success' if all succeeded, 'partial_success' if some succeeded, 'failure' if all failed
success, partial_success, failure Array of user IDs that were successfully processed
Array of failures with error details
Show child attributes
Show child attributes
Was this page helpful?