driveItemVersion resource type

Namespace: microsoft.graph

Represents a specific version of a driveItem.

The following tasks are available for driveItemVersion resources.

Common task HTTP method
List versions GET /drive/items/{item-id}/versions
Get version GET /drive/items/{item-id}/versions/{version-id}
Get contents GET /drive/items/{item-id}/versions/{version-id}/content
Restore version POST /drive/items/{item-id}/versions/{version-id}/restoreversion

In the previous table, the examples use /drive, but there are many valid requests.


Property Type Description
content Stream The content stream for this version of the item.
id String The ID of the version. Read-only.
lastModifiedBy identitySet Identity of the user who last modified the version. Read-only.
lastModifiedDateTime DateTimeOffset Date and time when the version was last modified. Read-only.
publication publicationFacet Indicates the publication status of this particular version. Read-only.
size Int64 Indicates the size of the content stream for this version of the item.

Instance attributes

Property name Type Description
@microsoft.graph.downloadUrl string A URL that can be used to download this version of the file's content. Authentication is not required with this URL. Read-only.

Notes: The @microsoft.graph.downloadUrl value is a short-lived URL and can't be cached. The URL is only available for a short period of time (1 hour) before it is invalidated. Removing file permissions for a user might not immediately invalidate the URL.

JSON representation

The following is a JSON representation of the resource.

  "content": { "@odata.type": "Edm.Stream" },
  "id": "String",
  "lastModifiedBy": { "@odata.type": "microsoft.graph.identitySet" },
  "lastModifiedDateTime": "String (timestamp)",
  "publication": { "@odata.type": "microsoft.graph.publicationFacet" },
  "size": "Int64",

  /* instance annotations */
  "@microsoft.graph.downloadUrl": "url",