AccountMerge()

This API is used to merge two existing libraries and close one of the associated accounts.

It is intended to merge the rights of an existing account in the case that a user may have accidentally created an additional Ultraviolet account.

API URL:

[BaseURL]/Account/{SurvivingAccountID}/Merge/{RetiringAccountID}

Request Method:

POST

Request Parameters:

SurvivingAccountID is the unique identifier for the Account which will survive the merge process
RetiringAccountID is the identifier for the Account which will be closed in merge process

Request Format

Headers:

Authorization: SAML2 assertion=[SurvivingAccountAssertion], SAML2 assertion=[RetiringAccountAssertion]

Response Format

Status Code:

HTTP 202 Accepted

Errors

RequestorPrivilegeInsufficient
- Only a full-access user can perform this action.
- HTTP Status Code: 403
SurvivingAccountCannotBeSameAsRetiringAccount
- The accounts being merged cannot be the same.
- HTTP Status Code: 403

Example

Merge account libraries

The following example requests an account be retired and all of the rights associated with it are merged into an exsisting account.

Sample Request:

POST /rest/2015/02/Account/urn:dece:accountid:org:dece:1A2EDE68C0764AA29589034B46CF5157/Merge/urn:dece:accountid:org:dece:A3819550C903455E9B282B1E419720A3 HTTP/1.1
Host: api.uvvu.com
Authorization: SAML2 assertion=[SurvivingAccountAssertion], SAML2 assertion=[RetiringAccountAssertion]

Sample Response:

HTTP/1.1 202 Accepted
Date: [Date]
Content-Type: text/plain
X-transaction-info: [TransactionInfo]

Locker merge has been accepted for processing, but the processing has not been completed