Automate role management in CodeRabbit with the new Custom Roles API

CodeRabbit launched a Custom Roles API for Enterprise customers, enabling programmatic creation, configuration, and assignment of user roles via REST endpoints. The API automates access management, allowing organizations to standardize onboarding, manage roles as code, and sync with identity systems like Rippling. It is available now for Enterprise users with Admin API keys.

Henry Lau Yiwen Xu June 05, 2026 2 min read June 05, 2026 2 min read Cut code review time & bugs by 50% Most installed AI app on GitHub and GitLab Free 14-day trial Until now, every custom role in CodeRabbit lived in the dashboard. An admin opened the Permissions page, built a role, set its read and write permissions, and assigned it to each user by hand. That's fine when you're onboarding a few people. It doesn't scale when you're a large organization with engineers joining, switching teams, and leaving every week. Today we're introducing the Custom Roles API for Enterprise https://docs.coderabbit.ai/api-reference/roles-create which are REST endpoints that let you create, configure, and assign custom roles programmatically. Everything you can do on the Permissions page can now be automated, so access scales with your headcount and you can get the most out of every CodeRabbit subscription. Standardize every new user. Set a role as the default with is default , and every new member starts with the right baseline access automatically. Manage roles as code. Define your org's roles in version control and create them through the API. Use duplicate from to base a new role like Security Reviewer on an existing one cr member by default , then adjust only the permissions that differ. Sync roles with your identity system. Connect the API to an HRIS like Rippling so the right role is granted the moment someone joins and revoked the moment they leave. Creating a new custom role takes a single call: POST https://api.coderabbit.ai/v1/roles x-coderabbitai-api-key: <your-key { "name": "Security Reviewer", "duplicate from": "cr member", "permissions": { "resource id": "user management", "access type": "read" } } Other new API endpoints include: The Custom Roles API turns access management from a click-by-click chore into something your systems handle on their own, provisioned consistently, updated instantly, and easy to govern as your team grows. It's available now for Enterprise customers. Generate an API key with Admin permissions from your CodeRabbit dashboard, and wire role management into the workflows you already run. Learn more: Create a custom role API reference https://docs.coderabbit.ai/api-reference/roles-create