Restore a previous version of a ListItem

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.


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.


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


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

HTTP/1.1 204 No Content