> For a complete page index, fetch https://developer.close.com/llms.txt

# Roles

[Roles](https://help.close.com/docs/roles-permissions) define what users in your organization can or cannot do.

Each user has a single role which you can set with a PUT request to [Memberships](/api/resources/memberships) API.

Every role has a set of permissions that represent actions users can do in Close.

Some roles, like "Admin" role, are maintained by the system and you cannot edit them.

Lead visibility related fields should be empty if the role has `view_all_leads` permission, and should be set otherwise.

> [Roles](https://help.close.com/docs/roles-permissions) define what users in your organization can or cannot do


## API Docs

- Roles [List all the roles defined for your organization](https://developer.close.com/api/resources/roles/list.md)
- Roles [Create a new role](https://developer.close.com/api/resources/roles/create.md)
- Roles [Fetch a single role](https://developer.close.com/api/resources/roles/get.md)
- Roles [Update existing role](https://developer.close.com/api/resources/roles/update.md)
- Roles [Delete a role](https://developer.close.com/api/resources/roles/delete.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developer.close.com/api/resources/roles/openapi.json)
- [OpenAPI YAML](https://developer.close.com/api/resources/roles/openapi.yaml)