# Docusign Roles API **Canonical:** https://apis.io/apis/docusign/docusign-roles-api/ **Provider:** Docusign — https://apis.io/providers/docusign/ **Base URL:** https://demo.docusign.net/restapi **Documentation:** https://developers.docusign.com/docs/esign-rest-api/ Docusign Roles API is one of 134 APIs that [Docusign](https://apis.io/providers/docusign/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. This API exposes 1 JSON Schema definition. Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, a JSON-LD context, a getting-started guide, rate-limit docs, and 1 JSON Schema. 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 console. ### 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. ## Machine-readable artifacts (31) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/docusign/refs/heads/main/openapi/docusign-roles-api-openapi.yml - **Documentation** — https://developers.docusign.com/docs/esign-rest-api/reference/ - **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/docusign/refs/heads/main/asyncapi/docusign-connect-asyncapi.yml - **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/docusign/refs/heads/main/json-schema/docusign-envelope-schema.json - **JSONLD** — https://raw.githubusercontent.com/api-evangelist/docusign/refs/heads/main/json-ld/docusign-context.jsonld - **GettingStarted** — https://developers.docusign.com/docs/esign-rest-api/esign101/ - **Tutorials** — https://developers.docusign.com/docs/esign-rest-api/how-to/ - **RateLimits** — https://developers.docusign.com/docs/esign-rest-api/esign101/rules-and-limits/ - **SDKs** — https://developers.docusign.com/docs/esign-rest-api/sdks/ - **GraphQL** — https://raw.githubusercontent.com/api-evangelist/docusign/refs/heads/main/graphql/docusign-graphql.md - **Documentation** — https://developers.docusign.com/docs/admin-api/reference/ - **GettingStarted** — https://developers.docusign.com/docs/admin-api/admin101/ - **Tutorials** — https://developers.docusign.com/docs/admin-api/how-to/ - **RateLimits** — https://developers.docusign.com/docs/admin-api/admin101/rules-and-limits/ - **SDKs** — https://developers.docusign.com/docs/admin-api/sdks/ - **Documentation** — https://developers.docusign.com/docs/click-api/reference/ - **GettingStarted** — https://developers.docusign.com/docs/click-api/click101/ - **Tutorials** — https://developers.docusign.com/docs/click-api/how-to/ - **RateLimits** — https://developers.docusign.com/docs/click-api/click101/rules-and-limits/ - **SDKs** — https://developers.docusign.com/docs/click-api/sdks/ - **Documentation** — https://developers.docusign.com/docs/maestro-api/reference/ - **GettingStarted** — https://developers.docusign.com/docs/maestro-api/maestro101/ - **Tutorials** — https://developers.docusign.com/docs/maestro-api/how-to/ - **Documentation** — https://developers.docusign.com/docs/monitor-api/reference/ - **GettingStarted** — https://developers.docusign.com/docs/monitor-api/monitor101/ - **Tutorials** — https://developers.docusign.com/docs/monitor-api/how-to/ - **Documentation** — https://developers.docusign.com/docs/rooms-api/reference/ - **GettingStarted** — https://developers.docusign.com/docs/rooms-api/rooms101/ - **Tutorials** — https://developers.docusign.com/docs/rooms-api/how-to/ - **RateLimits** — https://developers.docusign.com/docs/rooms-api/rooms101/rules-and-limits/ - **SDKs** — https://developers.docusign.com/docs/rooms-api/sdks/ ## Other Docusign APIs (12) - [Docusign Web Forms API](https://apis.io/apis/docusign/docusign-web-forms-api/) - [Docusign Notary API](https://apis.io/apis/docusign/docusign-notary-api/) - [Docusign Navigator API](https://apis.io/apis/docusign/docusign-navigator-api/) - [Docusign Workspaces API](https://apis.io/apis/docusign/docusign-workspaces-api/) - [Docusign CLM API](https://apis.io/apis/docusign/docusign-clm-api/) - [Docusign Connected Fields API](https://apis.io/apis/docusign/docusign-connected-fields-api/) - [Docusign AccountBrands API](https://apis.io/apis/docusign/docusign-accountbrands-api/) - [Docusign AccountConsumerDisclosures API](https://apis.io/apis/docusign/docusign-accountconsumerdisclosures-api/) - [Docusign AccountCustomFields API](https://apis.io/apis/docusign/docusign-accountcustomfields-api/) - [Docusign AccountPasswordRules API](https://apis.io/apis/docusign/docusign-accountpasswordrules-api/) - [Docusign AccountPermissionProfiles API](https://apis.io/apis/docusign/docusign-accountpermissionprofiles-api/) - [Docusign Accounts API](https://apis.io/apis/docusign/docusign-accounts-api/) ## Tags Roles --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/docusign/docusign-roles-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/docusign/.