Edit

Restore a previous version of a ListItem

  • Article

Restore a previous version of a ListItem to be the current version. This will create a new version with the contents of the previous version, but preserves all existing versions of the item.

Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission type Permissions (from least to most privileged)
Delegated (work or school account) Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All
Delegated (personal Microsoft account) n/a
Application Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All

HTTP request

POST /sites/{site-id}/items/{item-id}/versions/{version-id}/restoreVersion
POST /sites/{site-id}/lists/{list-id}/items/{item-id}/versions/{version-id}/restoreVersion

Request body

No request body is required.

Example

This example restores a version of a listItem identified by {item-id} and {version-id}.

POST /sites/{site-id}/lists/{list-id}/items/{item-id}/versions/{version-id}/restoreVersion

Response

If successful, the API call returns a 204 No Content.

HTTP/1.1 204 No Content