Delete multiple user authorizations
Delete one or more user authorizations for a given principal user. The principal user is specified by the userId path parameter.
To call this endpoint, you must be an account administrator or you must be the principal user for the specified authorizations.
Authorization
OAuth2 OAuth 2.0 access token obtained via Authorization Code Grant or JWT Grant.
In: header
Path Parameters
The external account number (int) or account ID GUID.
The ID of the principal user.
Response Body
application/json
application/json
curl -X DELETE "https://example.com/v2.1/accounts/string/users/string/authorizations"{ "results": [ { "authorizationId": "string", "errorMessage": "string", "success": "string" } ]}Create or update multiple user authorizations POST
Create or update multiple user authorizations in a single request. The body of the request is a list of userAuthorizationSomething objects. To create a new authorization, specify the `agentUser` and `permission` fields, with the optional `startDate` and `endDate` fields. To update an existing authorization, specify the `authorizationId` field and the `startDate` and/or `endDate` fields. For example, to create a new authorization and update the end date of an existing authorization, your request body might look like this: ``` { "authorizations": [ { "agentUser": { "userId": "1470ff66-xxxx-xxxx-xxxx-8c46f140da37", "accountId": "230546a7-xxxx-xxxx-xxxx-af205d5494ad" }, "permission": "manage" }, { "authorizationId": "b73ac983-xxxx-xxxx-xxxx-b3c0ea5b09d3", "endDate": "2023-05-09T21:36:27.0000000+00:00" } ] } ``` The principal user is specified by the `userId` path parameter. To call this endpoint, you must be an account administrator or the principal user. **Note:** To create an authorization with signing permission, the `AllowDelegationSigning` setting must be enabled on the account. If you share signing access, the agent user will receive an email notification. Each principal user can only share signing permission with one agent user.
Returns the authorizations for which the specified user is the agent user GET
Returns the user authorizations for which the user specified by `userId` is the agent user. If the calling user is an account administrator, the full results will be returned. Otherwise, only authorizations for which the calling user is the principal user will be returned.