> 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

# RequestShares Resource

The principals a request is shared with.

## Methods supported

| Method                                                                                                    | Description                                                                                                 |
| --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| [addRequestShares](/docs/agreement-desk-api/reference/agreementdesk/requestshares/addrequestshares)       | POST `/v1/accounts/{accountId}/requests/{requestId}/shares/actions/add` Share a request with principals     |
| [getRequestShares](/docs/agreement-desk-api/reference/agreementdesk/requestshares/getrequestshares)       | GET `/v1/accounts/{accountId}/requests/{requestId}/shares` List the principals a request is shared with     |
| [removeRequestShares](/docs/agreement-desk-api/reference/agreementdesk/requestshares/removerequestshares) | POST `/v1/accounts/{accountId}/requests/{requestId}/shares/actions/remove` Remove principals from a request |

## RequestShares properties

| Property            | Type              | Description                                                  |
| ------------------- | ----------------- | ------------------------------------------------------------ |
| `_links`            | RequestShareLinks |                                                              |
| `response_metadata` | ResponseMetadata  |                                                              |
| `principals`        | array             | The principals that have been granted access to the request. |


## API Docs

- RequestShares [Share request with principals](https://developers.docusign.com/docs/agreement-desk-api/reference/agreementdesk/requestshares/addrequestshares.md)
- RequestShares [List principals request is shared with](https://developers.docusign.com/docs/agreement-desk-api/reference/agreementdesk/requestshares/getrequestshares.md)
- RequestShares [Remove principals from request](https://developers.docusign.com/docs/agreement-desk-api/reference/agreementdesk/requestshares/removerequestshares.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)