# Hold and Release Documents

You can use the SharePoint Remote Connector to place holds on list items in SharePoint.

When the connector places a hold on a document, the document is left where it is and cannot be edited or deleted. The connector does not support in-place holds, introduced in SharePoint 2013, which allow documents to be edited or deleted while the version that was held is preserved.

The connector can be used to place multiple holds on a document - for example when you are placing holds for different legal cases. An item cannot be edited or deleted until all of the holds placed on it are removed. The hold to which you want to add items is specified by the `HoldName` parameter in the connector's configuration file. You can override this parameter in the `hold` fetch action by using the `config` action parameter to supply a different configuration.

To place and release holds, the following properties must be present in the document identifiers used in the `hold` or `releasehold` actions:

`SITECOLLECTIONURL` | The URL of the site collection that contains the item.
`SITEID` | The GUID of the site that contains the item.
`LISTID` | The GUID of the list that contains the item.
`LISTITEMID` | The integer ID of the item in the list.

These properties are included in all identifiers returned by the connector.

Place a Hold on a List Item

To place a hold, use the `Hold` fetch action. You must specify the identifiers of the documents to hold. You can use the `config` action parameter to specify configuration settings to use, such as the name of the hold to which you want to add the documents:

    http://host:port/action=Fetch
                              &FetchAction=Hold
                              &Identifiers=Document_Identifiers
                              &Config=...

For more information about this action, refer to the SharePoint Remote Connector Reference.

Release Documents

To release documents, use the `ReleaseHold` fetch action. You must specify the identifiers of the documents to release:

    http://host:port/action=Fetch
                              &FetchAction=ReleaseHold
                              &Identifiers=Document_Identifiers
                              &Config=...

For more information about this action, refer to the SharePoint Remote Connector Reference.

_FT_HTML5_bannerTitle.htm