Manage organization roles and permissions through Clerk's API

You can now implement completely manage permissions and roles through the Clerk Backend API. Build sophisticated access control systems tailored to your application's needs — whether you're syncing roles from external systems, automating permission assignments, or creating custom admin interfaces.

What's new

The following endpoints are now available on Clerk's backend API:

Organization Permissions

• GET /v1/organization_permissions - List all permissions with pagination and filtering
• POST /v1/organization_permissions - Create a new permission
• GET /v1/organization_permissions/{permission_id} - Retrieve a specific permission
• PATCH /v1/organization_permissions/{permission_id} - Update a permission
• DELETE /v1/organization_permissions/{permission_id} - Delete a permission

Organization Roles

• GET /v1/organization_roles - List all roles
• POST /v1/organization_roles - Create a new role
• GET /v1/organization_roles/{role_id} - Retrieve a specific role
• PATCH /v1/organization_roles/{role_id} - Update a role
• DELETE /v1/organization_roles/{role_id} - Delete a role

Role Permissions

• POST /v1/organization_roles/{role_id}/permissions/{permission_id} - Assign a permission to a role
• DELETE /v1/organization_roles/{role_id}/permissions/{permission_id} - Remove a permission from a role

Getting started

Visit the API reference⁠ for detailed documentation on request parameters and response formats.