Take Control of a User's Objects

An administrator can take control of a user's vApps, media, and catalogs.

When an administrator retrieves a User element, it contains a link that the administrator can use to take ownership of that user's vApps, media, and catalogs. This action is typically required when a user leaves the organization and an administrator must transfer ownership of that user's objects to other users.

Note: Starting with API version 38.0, the following endpoints are deprecated.


API Endpoint	Description
GET /admin/user/{id}	Retrieve a user.
PUT /admin/user/{id}	Update a user.
DELETE /admin/user/{id}	Delete a user.
POST /admin/user/{id}/action/takeOwnership	Transfer ownership of this user's vApps, media, and catalogs to the called.
GET /admin/users/query	Retrieves a list of users for the organization that the organization administrator belongs to by using REST API general QueryHandler.

Prerequisites

This operation requires the rights included in the predefined Organization Administrator role or an equivalent set of rights.

Procedure

Retrieve the XML representation of the user.
Use a request like this one:
```
GET https://vcloud.example.com/api/admin/user/85
```

Examine the response to find the link where rel="takeOwnership".

<User
   ...
   href="https://vcloud.example.com/api/admin/user/85" ... >
   ...
   <Link
      rel="takeOwnership"
      href="https://vcloud.example.com/api/admin/user/85/action/takeOwnership"/>
   ... 
</User>

Make a POST request to the URL in the href value of that link.
```
POST  https://vcloud.example.com/api/admin/user/85/action/takeOwnership
```
The response is empty (204 No Content).

Results

All vApps, media, and catalogs that belonged to the user now belong to the administrator who made the request. The administrator can then change the ownership as needed. See View or Change the Owner of an Object.