# Manage organization roles and permissions through Clerk's 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](https://clerk.com/docs/reference/backend-api) for detailed documentation on request parameters and response formats.