How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Docusign Roles API

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 SettingsRooms 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 RolesIn 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.

Docusign Roles API is one of 134 APIs that Docusign publishes on the 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.

This API exposes 5 operations across 2 paths, and defines 7 schemas. It is described by OpenAPI 3.2.0, at version v2.

Requests are made against a single base URL, https://rooms.docusign.com/restapi.

5 operations 2 paths 7 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v2
Base URL
https://demo.docusign.net/restapi
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Docusign Roles API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Bearer). By default, every request must be authenticated.

  • Bearer — JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Roles 5

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.…

GET
/v2/accounts/{accountId}/roles
Docusign Gets roles.
Roles_GetRoles 6 params → 200400401
POST
/v2/accounts/{accountId}/roles
Docusign Creates a role.
Roles_CreateRole 1 param body → 201400401
GET
/v2/accounts/{accountId}/roles/{roleId}
Docusign Gets a role.
Roles_GetRole 3 params → 200400401
PUT
/v2/accounts/{accountId}/roles/{roleId}
Docusign Updates a role.
Roles_UpdateRole 2 params body → 200400401
DELETE
/v2/accounts/{accountId}/roles/{roleId}
Docusign Deletes a role.
Roles_DeleteRole 2 params → 204400401

Schemas 7

The contract defines 7 schemas that model the data the API accepts and returns. The most detailed are Permissions (66 properties), Role (8 properties), RoleSummaryList (7 properties), RoleSummary (6 properties). Each schema is shown below with its type and property counts.

RoleSummary
object
Contains details about a role.
6 properties
RoleForUpdate
object
This request object contains the details to use for the update.
3 properties
ApiError
object
This object describes errors that occur. It is valid only for responses and ignored in requests.
3 properties
RoleSummaryList
object
This complex type contains details about the roles that are associated with an account.
7 properties
Role
object
Contains details about a company role.
8 properties
RoleForCreate
object
Contains details about the role that you want to create.
3 properties
Permissions
object
Contains details about permissions.
66 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

docusign-roles-api-openapi.yml Raw ↑

Other APIs Docusign publishes across the network.

Docusign Web Forms API
Docusign Notary API
Docusign Navigator API
Docusign Workspaces API
Docusign CLM API
Docusign Connected Fields API
Docusign AccountBrands API
Docusign AccountConsumerDisclosures API
Docusign AccountCustomFields API
Docusign AccountPasswordRules API
Docusign AccountPermissionProfiles API
Docusign Accounts API
Where this information came from

This is an independent, third-party profile of Docusign Roles API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.