1. Operations
2. content
3. library
4. item
5. update session

## content library item update session: fail

Terminates the update session with a client specified error message.

This is useful in transmitting client side failures (for example, not being able to access a file) to the server side.

### Request:

#### HTTP request

POST https://{server}/rest/com/vmware/content/library/item/update-session/id:{update_session_id}?~action=fail

#### Path Parameters

Name | Type | Description
--- | --- | ---
Required
update_session_id | string | Identifier of the update session to fail.

#### Request Body Structure:

- JSON
- XML

{
"client_error_message": "string"
}
<?xml version="1.0" ?>
<ns0:Fail-Input xmlns:ns0="http://vmware.com/content/library/item/update_session" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<client_error_message>string</client_error_message>
</ns0:Fail-Input>

#### Request Body Parameters:

Name | Type | Description
--- | --- | ---
bold = required
client_error_message | string | Client side error message. This can be useful in providing some extra details about the client side failure. Note that the message won't be translated to the user's locale.

### Response:

#### HTTP Status Code: 200

None

#### Errors:

HTTP Status Code | Type | Description
--- | --- | ---
404 | not_found | if the update session does not exist.
400 | not_allowed_in_current_state | if the update session is not in the ACTIVE state.