> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Roles Category

Each role is associated with specific permissions. Each new member is assigned a role when you create them, automatically granting them the permissions associated with that role.

Roles use the following permission types to control the actions that users can perform:

* Room
* Room Details
* Documents
* Envelopes
* Member Management
* Company Settings

Rooms enables you to configure custom roles containing permissions that make sense for your company. Because each new member is assigned a role, you must set up these roles before you can invite members to join your account.

Permissions for roles are tied to the `roleId` property and not yet exposed. You can learn more about these permission types and configure them in the web application.

### Internal and External Roles

In Rooms, a role can be either internal or external. You assign internal roles to people inside your company. You assign external roles to people outside your company when you invite them to a room.

Each member inside your company has a default company role. However, they can also be assigned additional roles with different permissions on a per-room basis. Regardless of the member's default company role, what they can do in a room is entirely controlled by their role in that particular room.

## [Roles](/docs/rooms-api/reference/roles/roles)

**Description**

This object contains information about a role.

**Methods supported**

* [CreateRole](/docs/rooms-api/reference/roles/roles/createrole)
* [DeleteRole](/docs/rooms-api/reference/roles/roles/deleterole)
* [GetRole](/docs/rooms-api/reference/roles/roles/getrole)
* [GetRoles](/docs/rooms-api/reference/roles/roles/getroles)
* [UpdateRole](/docs/rooms-api/reference/roles/roles/updaterole)

## Docs

- [Roles Resource](https://developers.docusign.com/docs/rooms-api/reference/roles/roles.md)

## API Docs

- Roles [Create role](https://developers.docusign.com/docs/rooms-api/reference/roles/roles/createrole.md)
- Roles [Delete role](https://developers.docusign.com/docs/rooms-api/reference/roles/roles/deleterole.md)
- Roles [Get role](https://developers.docusign.com/docs/rooms-api/reference/roles/roles/getrole.md)
- Roles [Get roles](https://developers.docusign.com/docs/rooms-api/reference/roles/roles/getroles.md)
- Roles [Update role](https://developers.docusign.com/docs/rooms-api/reference/roles/roles/updaterole.md)

## OpenAPI Specification

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