> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.awork.com/apiv1/roles/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.awork.com/_mcp/server.

# Roles


## API Docs

- Roles [Returns roles of the workspace.](https://developers.awork.com/apiv1/roles/get-roles.md)
- Roles [Creates a workspace role.](https://developers.awork.com/apiv1/roles/post-role.md)
- Roles [Moves a user to another role.](https://developers.awork.com/apiv1/roles/post-roles-move-user.md)
- Roles [Returns all users in roles of the workspace.](https://developers.awork.com/apiv1/roles/get-roles-users.md)
- Roles [Returns the role.](https://developers.awork.com/apiv1/roles/get-role-by-id.md)
- Roles [Updates the role.](https://developers.awork.com/apiv1/roles/put-role-by-id.md)
- Roles [Adds the user to the role.](https://developers.awork.com/apiv1/roles/post-role-add-user-by-role-id.md)
- Roles [Returns deactivated menu items for the role.](https://developers.awork.com/apiv1/roles/get-role-deactivated-menu-items-by-role-id.md)
- Roles [Updates deactivated menu items for a role.](https://developers.awork.com/apiv1/roles/post-role-deactivated-menu-items-by-role-id.md)
- Roles [Deletes the role.](https://developers.awork.com/apiv1/roles/post-role-delete-by-role-id.md)
- Roles [Returns permissions of the specified role.](https://developers.awork.com/apiv1/roles/get-role-permissions-by-role-id.md)
- Roles [Updates permissions for a role.](https://developers.awork.com/apiv1/roles/post-role-permissions-by-role-id.md)
- Roles [Archives or unarchives the role.](https://developers.awork.com/apiv1/roles/post-role-set-archived-by-role-id.md)
- Roles [Returns users of the specified role.](https://developers.awork.com/apiv1/roles/get-role-users-by-role-id.md)
- Roles [Activates the user.](https://developers.awork.com/apiv1/roles/post-role-user-activate-by-role-id-and-user-id.md)
- Roles [Deactivates the user.](https://developers.awork.com/apiv1/roles/post-role-user-deactivate-by-role-id-and-user-id.md)
- Roles [Returns the role for the name.](https://developers.awork.com/apiv1/roles/get-role-by-role-name.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developers.awork.com/apiv1/roles/openapi.json)
- [OpenAPI YAML](https://developers.awork.com/apiv1/roles/openapi.yaml)