Nov 24

Manage organization roles and permissions through Clerk's API

Category: Organizations
Published: Nov 24

Build custom role based access control (RBAC) systems by managing organization roles and permissions via an API.

You can now 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

Endpoint	Description
`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

Endpoint	Description
`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

Endpoint	Description
`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.