> 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

# Authorizations Resource

A user authorization is created to share access between users on the same account. One user can be given access to sign, manage, or send on behalf of another. These endpoints allow you to create, delete, and manage user authorizations.

## Methods supported

| Method                                                                                                                  | Description                                                                                                                                             |
| ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [createUserAuthorization](/docs/esign-rest-api/reference/accounts/authorizations/createuserauthorization)               | POST `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorization` Creates a user authorization.                                                    |
| [createUserAuthorizations](/docs/esign-rest-api/reference/accounts/authorizations/createuserauthorizations)             | POST `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorizations` Create or update multiple user authorizations.                                  |
| [deleteUserAuthorization](/docs/esign-rest-api/reference/accounts/authorizations/deleteuserauthorization)               | DEL `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorization/{authorizationId}` Deletes the user authorization.                                 |
| [deleteUserAuthorizations](/docs/esign-rest-api/reference/accounts/authorizations/deleteuserauthorizations)             | DEL `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorizations` Delete multiple user authorizations.                                             |
| [getAgentUserAuthorizations](/docs/esign-rest-api/reference/accounts/authorizations/getagentuserauthorizations)         | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorizations/agent` Returns the authorizations for which the specified user is the agent user. |
| [getPrincipalUserAuthorizations](/docs/esign-rest-api/reference/accounts/authorizations/getprincipaluserauthorizations) | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorizations` Returns the authorizations for which the specified user is the principal user.   |
| [getUserAuthorization](/docs/esign-rest-api/reference/accounts/authorizations/getuserauthorization)                     | GET `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorization/{authorizationId}` Returns the user authorization for a given authorization ID.    |
| [updateUserAuthorization](/docs/esign-rest-api/reference/accounts/authorizations/updateuserauthorization)               | PUT `/restapi/v2.1/accounts/{accountId}/users/{userId}/authorization/{authorizationId}` Updates the start or end date for a user authorization.         |

## Authorizations properties

| Property          | Type              | Description                                                                                    |
| ----------------- | ----------------- | ---------------------------------------------------------------------------------------------- |
| `agentUser`       | authorizationUser |                                                                                                |
| `authorizationId` | string            |                                                                                                |
| `created`         | string            | The UTC DateTime when the workspace user authorization was created.                            |
| `createdBy`       | string            |                                                                                                |
| `endDate`         | string            |                                                                                                |
| `modified`        | string            |                                                                                                |
| `modifiedBy`      | string            | The user ID (GUID) of the user who last modified this user record. This property is read-only. |
| `permission`      | string            |                                                                                                |
| `principalUser`   | authorizationUser |                                                                                                |
| `startDate`       | string            |                                                                                                |
| `taskSource`      | string            |                                                                                                |
| `taskType`        | string            |                                                                                                |


## API Docs

- Authorizations [Create user authorization](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/createuserauthorization.md)
- Authorizations [Create or update multiple user authorizations](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/createuserauthorizations.md)
- Authorizations [Delete user authorization](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/deleteuserauthorization.md)
- Authorizations [Delete multiple user authorizations](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/deleteuserauthorizations.md)
- Authorizations [Get authorizations for which user is agent user](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/getagentuserauthorizations.md)
- Authorizations [List principal user authorizations](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/getprincipaluserauthorizations.md)
- Authorizations [Get user authorization for authorization id](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/getuserauthorization.md)
- Authorizations [Update start or end date for user authorization](https://developers.docusign.com/docs/esign-rest-api/reference/accounts/authorizations/updateuserauthorization.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)