# Permissions categories

## Get permissions categories

 - [GET /resources/permissions/v1/categories](https://developers.frontegg.com/ciam/api/identity/permissions-categories/permissionscategoriescontroller_getallcategorieswithpermissions.md): Retrieves all permission categories for your environment. Each category includes its name, description, associated permissions, and metadata.

## Create category

 - [POST /resources/permissions/v1/categories](https://developers.frontegg.com/ciam/api/identity/permissions-categories/permissionscategoriescontroller_createpermissioncategory.md): Add a new permissions category.

Provide the category information in the request body. Note that categories are not associated with permissions in this route — you can associate permissions by sending the category ID in the add or update permission routes.

## Update category

 - [PATCH /resources/permissions/v1/categories/{categoryId}](https://developers.frontegg.com/ciam/api/identity/permissions-categories/permissionscategoriescontroller_updatecategory.md): Update an existing permissions category.

Provide the category ID as a path parameter to specify which category to update, and send the updated category information in the request body.

This route does not update the permissions associated with the category. Use the add or update permissions routes to manage permission associations.

## Delete category

 - [DELETE /resources/permissions/v1/categories/{categoryId}](https://developers.frontegg.com/ciam/api/identity/permissions-categories/permissionscategoriescontroller_deletecategory.md): Delete a permissions category.

Provide the category ID as a path parameter to specify which category to delete. You can obtain the category ID using the Get categories API.