> 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 # Workspaces API ## Docs - [Workspaces API 101](https://developers.docusign.com/docs/workspaces-api/workspaces101.md): Read an overview of the Workspaces API, how it can help you manage complex agreements, and when using a workspace can simplify your processes. - [Workspaces API concepts](https://developers.docusign.com/docs/workspaces-api/workspaces101/concepts.md): Learn about the basic concepts and objects used by the Workspaces API - [Workspaces API use cases](https://developers.docusign.com/docs/workspaces-api/workspaces101/use-cases.md): See details about common Workspaces API use cases. - [How-to guides overview](https://developers.docusign.com/docs/workspaces-api/how-to.md): Discover how to use the Workspaces API in these step-by-step lessons. - [How to create a workspace](https://developers.docusign.com/docs/workspaces-api/how-to/create-workspace.md): See how to create a workspace using API calls. - [How to add a document to Workspace](https://developers.docusign.com/docs/workspaces-api/how-to/add-a-document.md): Learn how to add a document to the Workspaces API - [How to send an envelope with recipient information](https://developers.docusign.com/docs/workspaces-api/how-to/send-envelope-with-recipient-information.md): This topic demonstrates how to create an envelope in a workspace with the Workspaces API and send it with recipient information using the eSignature REST API. - [How to create a workspace with a brand](https://developers.docusign.com/docs/workspaces-api/how-to/create-workspace-with-brand.md): Learn how to create a workspace using the Docusign Workspaces API and associate it with an existing eSignature brand for consistent, branded experiences. - [How to create a workspace upload request](https://developers.docusign.com/docs/workspaces-api/how-to/create-workspace-upload-request.md): See how to create a workspace upload request using API calls. - [Authentication](https://developers.docusign.com/docs/workspaces-api/auth.md): Learn how to authenticate to call Workspaces API endpoints. - [Go Live and API base paths](https://developers.docusign.com/docs/workspaces-api/go-live.md): Learn how to Go-Live with Workspaces API apps. - [Workspaces API rules and resource limits](https://developers.docusign.com/docs/workspaces-api/rules-and-resource-limits.md): See the rules and resource limits enforced for the Workspaces API. - [API Categories](https://developers.docusign.com/docs/workspaces-api/reference.md) - [Workspaces Category](https://developers.docusign.com/docs/workspaces-api/reference/workspaces.md) - [WorkspaceBrands Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacebrands.md) - [WorkspaceDocuments Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments.md) - [WorkspaceEnvelopes Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceenvelopes.md) - [Workspaces Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces.md) - [WorkspaceUploadRequest Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest.md) - [WorkspaceUsers Resource](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers.md) ## API Docs - Docusign Workspaces API > Workspaces > WorkspaceBrands [Returns details about the brand set for a workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacebrands/getworkspacebrand.md) - Docusign Workspaces API > Workspaces > WorkspaceBrands [Updates brand for an existing workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacebrands/updateworkspacebrand.md) - Docusign Workspaces API > Workspaces > WorkspaceDocuments [Add a document to a workspace via file contents upload](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments/addworkspacedocument.md) - Docusign Workspaces API > Workspaces > WorkspaceDocuments [Deletes a document in the workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments/deleteworkspacedocument.md) - Docusign Workspaces API > Workspaces > WorkspaceDocuments [Get information about the document](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments/getworkspacedocument.md) - Docusign Workspaces API > Workspaces > WorkspaceDocuments [Get the file contents of the document](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments/getworkspacedocumentcontents.md) - Docusign Workspaces API > Workspaces > WorkspaceDocuments [Get documents in the workspace accessible to the calling user](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspacedocuments/getworkspacedocuments.md) - Docusign Workspaces API > Workspaces > WorkspaceEnvelopes [Import envelopes with specified envelopeIds into a Workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceenvelopes/importenvelopes.md) - Docusign Workspaces API > Workspaces > Workspaces [Creates a new workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/createworkspace.md) - Docusign Workspaces API > Workspaces > Workspaces [Creates an envelope with the given documents. Returns the ID of the created envelope](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/createworkspaceenvelope.md) - Docusign Workspaces API > Workspaces > Workspaces [Returns details about the workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/getworkspace.md) - Docusign Workspaces API > Workspaces > Workspaces [Returns the roles the caller can assign to workspace users](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/getworkspaceassignableroles.md) - Docusign Workspaces API > Workspaces > Workspaces [Returns the envelopes associated with the given workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/getworkspaceenvelopes.md) - Docusign Workspaces API > Workspaces > Workspaces [Gets workspaces available to the calling user](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/getworkspaces.md) - Docusign Workspaces API > Workspaces > Workspaces [Updates an existing workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaces/updateworkspace.md) - Docusign Workspaces API > Workspaces > WorkspaceUploadRequest [Creates a new upload request within a workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/createworkspaceuploadrequest.md) - Docusign Workspaces API > Workspaces > WorkspaceUploadRequest [Deletes a specific upload request](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/deleteworkspaceuploadrequest.md) - Docusign Workspaces API > Workspaces > WorkspaceUploadRequest [Gets details for a specific upload request](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/getworkspaceuploadrequest.md) - Docusign Workspaces API > Workspaces > WorkspaceUploadRequest [Gets upload requests within a workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/getworkspaceuploadrequests.md) - Docusign Workspaces API > Workspaces > WorkspaceUploadRequest [Updates a specific upload request](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceuploadrequest/updateworkspaceuploadrequest.md) - Docusign Workspaces API > Workspaces > WorkspaceUsers [Adds a user to the workspace by email address](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers/addworkspaceuser.md) - Docusign Workspaces API > Workspaces > WorkspaceUsers [Retrieves the list of users in the given workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers/getworkspaceusers.md) - Docusign Workspaces API > Workspaces > WorkspaceUsers [Restores the specified user's access to the workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers/restoreworkspaceuseraccess.md) - Docusign Workspaces API > Workspaces > WorkspaceUsers [Revokes the specified user's access to the workspace](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers/revokeworkspaceuseraccess.md) - Docusign Workspaces API > Workspaces > WorkspaceUsers [Updates the specified user's role](https://developers.docusign.com/docs/workspaces-api/reference/workspaces/workspaceusers/updateworkspaceuser.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) > **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page. > 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 # Workspaces API overview > The Workspaces API allows developers to create, manage, and integrate Docusign Workspaces into their own applications—enabling structured, secure, and scalable agreement workflows. The Workspaces API enables developers to create, manage, and integrate Docusign Workspaces into their own applications to create structured, secure, and scalable agreement workflows. Workspaces provide a centralized environment where documents, participants, and envelopes come together to support complex, multi-step agreements. With this API, developers can integrate workspace functionality into internal systems or customer solutions, assign roles and permissions, and streamline collaboration across agreement stages—all while maintaining real-time visibility, control, and security. ## Places to start * [Explore the API reference](/docs/workspaces-api/reference) * [Authenticate to use the Workspaces API](/docs/workspaces-api/auth) * [Optimize customer experiences using the Workspaces API](https://players.brightcove.net/6118377982001/FNrhUIBZEs_default/index.html?videoId=6371265920112) ## Features #### Create and manage Workspaces Programmatically create workspaces to group documents, participants, and agreement steps into a single structured environment—enabling a more organized and trackable workflow. #### Send tasks via Workspaces Send one or more envelopes to the same or different set of recipients via a Workspaces API endpoint for sending envelopes. All the relevant envelopes (depending on the access) will be seen within the workspace for the users. #### Upload and manage documents Easily add, tag, retrieve, and organize documents within a workspace using REST API methods. Maintain control over the document lifecycle while keeping related files in one secure location. #### Role-based access and permissions Assign roles and control participant access through API. Ensure the right people can view, act on, or edit the appropriate documents—supporting collaboration and compliance in high-trust workflows. ## Discover more * [See the requirements to go-live with a workspaces API app](/docs/workspaces-api/go-live) * [Authenticate to use the Workspaces API](/docs/workspaces-api/auth)