---
title: "REST API: Roles and Permissions"
type: "wiki"
space: "Axero Documentation"
author: "Anonymous User"
created: 2015-05-18T14:24:44Z
updated: 2026-08-24T13:09:57Z
tags: ["API"]
url: "https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/4938/rest-api-user-roles-overview"
---

# REST API: Roles and Permissions

[Open API Guide](https://my.axerosolutions.com/spaces/5/axero-documentation/api-guide?id=4938)

Dynamically assign users to roles, query effective permissions for specific resources, and automate security compliance workflows for platform administrators.

## Available Endpoints

| Method | Endpoint | Description |
| :--- | :--- | :--- |
| POST | [Add Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/444/api)<br>`/api/roles` | Add a new top level role |
| POST | [Assign User Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/449/api)<br>`/api/users/{UserID}/roles` | Assign top level roles to a user |
| GET | [Check Permissions](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/25128/api)<br>`/api/permissions/access` | Get permissions JSON object from database. List of supported entities: Articles, Blogs, CMS Pages, Wikis, Files, Videos, Ideas, Photos, Events, Forums, Cases. |
| DELETE | [Delete Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/445/api)<br>`/api/roles/{roleid}` | Provides an automated mechanism for removing delete role data from the system. |
| GET | [Get Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/443/api)<br>`/api/roles/{RoleID}` | Enables administrators and developers to programmatically retrieve a top level role. |
| GET | [Get Roles](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/447/api)<br>`/api/roles` | Enables administrators and developers to programmatically retrieve all top level roles. |
| GET | [Get User Roles](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/448/api)<br>`/api/users/{UserID}/roles` | Enables administrators and developers to programmatically retrieve a user's top level roles. |
| DELETE | [Unassign Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/450/api)<br>`/api/users/{UserID}/roles/{RoleID}` | Provides an automated mechanism for removing remove user role data from the system. |
| PUT | [Update Permissions](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/32996/api)<br>`/api/permissions/access` | Supports the synchronization and modification of update role permissions properties via the API. |
| PUT | [Update Role](https://my.axerosolutions.com/spaces/5/axero-documentation/wiki/view/446/api)<br>`/api/roles/{RoleID}` | Supports the synchronization and modification of update role properties via the API. |