Files.ReadWrite.All
Allows the app to read, create, update and delete all files the signed-in user can access.
Graph Methods
Type: A = Application Permission, D = Delegate Permission
Delegate Permission
Id | 863451e7-0667-486c-a5d6-d135439485f0 |
Consent Type | User |
Display String | Have full access to all files user can access |
Description | Allows the app to read, create, update and delete all files the signed-in user can access. |
Application Permission
Id | 75359482-378d-4052-8f01-80520e7db3cd |
Display String | Read and write files in all site collections |
Description | Allows the app to read, create, update and delete all files in all site collections without a signed in user. |
Resources
bundle
channel
Property | Type | Description |
---|---|---|
createdDateTime | dateTimeOffset | Read only. Timestamp at which the channel was created. |
description | String | Optional textual description for the channel. |
displayName | String | Channel name as it will appear to the user in Microsoft Teams. The maximum length is 50 characters. |
String | The email address for sending messages to the channel. Read-only. | |
id | String | The channel's unique identifier. Read-only. |
isFavoriteByDefault | Boolean | Indicates whether the channel should automatically be marked 'favorite' for all members of the team. Can only be set programmatically with Create team. Default: false . |
membershipType | channelMembershipType | The type of the channel. Can be set during creation and can't be changed. The possible values are: standard , private , unknownFutureValue , shared . The default value is standard . Note that you must use the Prefer: include-unknown-enum-members request header to get the following value in this evolvable enum: shared . |
tenantId | string | The ID of the Azure Active Directory tenant. |
webUrl | String | A hyperlink that will go to the channel in Microsoft Teams. This is the URL that you get when you right-click a channel in Microsoft Teams and select Get link to channel. This URL should be treated as an opaque blob, and not parsed. Read-only. |
deleted
Property | Type | Description |
---|---|---|
state | String | Represents the state of the deleted item. |
drive
Property | Type | Description |
---|---|---|
createdBy | [identitySet][] | Identity of the user, device, or application which created the item. Read-only. |
createdDateTime | dateTimeOffset | Date and time of item creation. Read-only. |
description | String | Provide a user-visible description of the drive. Read-write. |
driveType | String | Describes the type of drive represented by this resource. OneDrive personal drives will return personal . OneDrive for Business will return business . SharePoint document libraries will return documentLibrary . Read-only. |
id | String | The unique identifier of the drive. Read-only. |
lastModifiedBy | [identitySet][] | Identity of the user, device, and application which last modified the item. Read-only. |
lastModifiedDateTime | dateTimeOffset | Date and time the item was last modified. Read-only. |
name | string | The name of the item. Read-write. |
owner | identitySet | Optional. The user account that owns the drive. Read-only. |
quota | quota | Optional. Information about the drive's storage space quota. Read-only. |
sharepointIds | [sharepointIds][] | Returns identifiers useful for SharePoint REST compatibility. Read-only. This property is not returned by default and must be selected using the $select query parameter. |
system | [systemFacet][] | If present, indicates that this is a system-managed drive. Read-only. |
webUrl | string (url) | URL that displays the resource in the browser. Read-only. |
driveItem
Property | Type | Description |
---|---|---|
audio | [audio][] | Audio metadata, if the item is an audio file. Read-only. Read-only. Only on OneDrive Personal. |
bundle | [bundle][] | Bundle metadata, if the item is a bundle. Read-only. |
content | Stream | The content stream, if the item represents a file. |
createdBy | [identitySet][] | Identity of the user, device, and application which created the item. Read-only. |
createdDateTime | DateTimeOffset | Date and time of item creation. Read-only. |
cTag | String | An eTag for the content of the item. This eTag is not changed if only the metadata is changed. Note This property is not returned if the item is a folder. Read-only. |
deleted | [deleted][] | Information about the deleted state of the item. Read-only. |
description | String | Provides a user-visible description of the item. Read-write. Only on OneDrive Personal. |
eTag | String | eTag for the entire item (metadata + content). Read-only. |
file | [file][] | File metadata, if the item is a file. Read-only. |
fileSystemInfo | [fileSystemInfo][] | File system information on client. Read-write. |
folder | [folder][] | Folder metadata, if the item is a folder. Read-only. |
id | String | The unique identifier of the item within the Drive. Read-only. |
image | [image][] | Image metadata, if the item is an image. Read-only. |
lastModifiedBy | [identitySet][] | Identity of the user, device, and application which last modified the item. Read-only. |
lastModifiedDateTime | DateTimeOffset | Date and time the item was last modified. Read-only. |
location | [geoCoordinates][] | Location metadata, if the item has location data. Read-only. |
malware | [malware][] | Malware metadata, if the item was detected to contain malware. Read-only. |
name | String | The name of the item (filename and extension). Read-write. |
package | [package][] | If present, indicates that this item is a package instead of a folder or file. Packages are treated like files in some contexts and folders in others. Read-only. |
parentReference | [itemReference][] | Parent information, if the item has a parent. Read-write. |
pendingOperations | [pendingOperations][] | If present, indicates that one or more operations that might affect the state of the driveItem are pending completion. Read-only. |
photo | [photo][] | Photo metadata, if the item is a photo. Read-only. |
publication | [publicationFacet][] | Provides information about the published or checked-out state of an item, in locations that support such actions. This property is not returned by default. Read-only. |
remoteItem | [remoteItem][] | Remote item data, if the item is shared from a drive other than the one being accessed. Read-only. |
root | [root][] | If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive. |
searchResult | [searchResult][] | Search metadata, if the item is from a search result. Read-only. |
shared | [shared][] | Indicates that the item has been shared with others and provides information about the shared state of the item. Read-only. |
sharepointIds | [sharepointIds][] | Returns identifiers useful for SharePoint REST compatibility. Read-only. |
size | Int64 | Size of the item in bytes. Read-only. |
specialFolder | [specialFolder][] | If the current item is also available as a special folder, this facet is returned. Read-only. |
video | [video][] | Video metadata, if the item is a video. Read-only. |
webDavUrl | String | WebDAV compatible URL for the item. |
webUrl | String | URL that displays the resource in the browser. Read-only. |
driverecipient
extractSensitivityLabelsResult
Property | Type | Description |
---|---|---|
labels | sensitivityLabelAssignment collection | List of sensitivity labels assigned to a file. |
itemActivity
Property | Type | Description |
---|---|---|
access | [accessAction][] | An item was accessed. |
activityDateTime | DateTimeOffset | Details about when the activity took place. Read-only. |
actor | [identitySet][] | Identity of who performed the action. Read-only. |
id | string | The unique identifier of the activity. Read-only. |
itemActivityStat
Property | Type | Description |
---|---|---|
access | [itemActionStat][] | Statistics about the access actions in this interval. Read-only. |
create | [itemActionStat][] | Statistics about the create actions in this interval. Read-only. |
delete | [itemActionStat][] | Statistics about the delete actions in this interval. Read-only. |
edit | [itemActionStat][] | Statistics about the edit actions in this interval. Read-only. |
endDateTime | DateTimeOffset | When the interval ends. Read-only. |
incompleteData | [incompleteData][] | Indicates that the statistics in this interval are based on incomplete data. Read-only. |
isTrending | Boolean | Indicates whether the item is "trending." Read-only. |
move | [itemActionStat][] | Statistics about the move actions in this interval. Read-only. |
startDateTime | DateTimeOffset | When the interval starts. Read-only. |
itemAnalytics
Property | Type | Description |
---|---|---|
allTime | [itemActivityStat][] | Analytics over the item's lifespan. |
lastSevenDays | [itemActivityStat][] | Analytics for the last seven days. |
ItemReference
Property | Type | Description |
---|---|---|
driveId | String | Unique identifier of the drive instance that contains the item. Read-only. |
driveType | String | Identifies the type of drive. See [drive][] resource for values. |
id | String | Unique identifier of the item in the drive. Read-only. |
name | String | The name of the item being referenced. Read-only. |
path | String | Path that can be used to navigate to the item. Read-only. |
shareId | String | A unique identifier for a shared resource that can be accessed via the [Shares][] API. |
sharepointIds | [sharepointIds][] | Returns identifiers useful for SharePoint REST compatibility. Read-only. |
siteId | String | For OneDrive for Business and SharePoint, this property represents the ID of the site that contains the parent document library of the driveItem resource. The value is the same as the id property of that site][] resource. It is an [opaque string that consists of three identifiers of the site. For OneDrive, this property is not populated. |
list
listitem
Property | Type | Description |
---|---|---|
contentType | [contentTypeInfo][] | The content type of this list item |
Permission
Property | Type | Description |
---|---|---|
expirationDateTime | DateTimeOffset | A format of yyyy-MM-ddTHH:mm:ssZ of DateTimeOffset indicates the expiration time of the permission. DateTime.MinValue indicates there is no expiration set for this permission. Optional. |
id | String | The unique identifier of the permission among all permissions on the item. Read-only. |
hasPassword | Boolean | Indicates whether the password is set for this permission. This property only appears in the response. Optional. Read-only. For OneDrive Personal only.. |
grantedTo (deprecated) | IdentitySet | For user type permissions, the details of the users and applications for this permission. Read-only. |
grantedToIdentities (deprecated) | Collection(IdentitySet) | For type permissions, the details of the users to whom permission was granted. Read-only. |
grantedToIdentitiesV2 | Collection([SharePointIdentitySet][]) | For link type permissions, the details of the users to whom permission was granted. Read-only. |
grantedToV2 | [SharePointIdentitySet][] | For user type permissions, the details of the users and applications for this permission. Read-only. |
inheritedFrom | ItemReference | Provides a reference to the ancestor of the current permission, if it is inherited from an ancestor. Read-only. |
invitation | [SharingInvitation][] | Details of any associated sharing invitation for this permission. Read-only. |
link | [SharingLink][] | Provides the link details of the current permission, if it is a link type permissions. Read-only. |
roles | Collection of String | The type of permission, for example, read . See below for the full list of roles. Read-only. |
shareId | String | A unique token that can be used to access this shared item via the shares API. Read-only. |
remoteItem
sharedDriveItem
Property | Type | Description |
---|---|---|
id | String | The unique identifier for the share being accessed. |
name | String | The display name of the shared item. |
owner | identitySet | Information about the owner of the shared item being referenced. |
sharingInvitation
sharingLink
Property | Type | Description |
---|---|---|
application | [identity][] | The app the link is associated with. |
preventsDownload | Boolean | If true then the user can only use this link to view the item on the web, and cannot use it to download the contents of the item. Only for OneDrive for Business and SharePoint. |
scope | String | The scope of the link represented by this permission. Value anonymous indicates the link is usable by anyone, organization indicates the link is only usable for users signed into the same tenant. |
type | String | The type of the link created. |
webHtml | String | For embed links, this property contains the HTML code for an <iframe> element that will embed the item in a webpage. |
webUrl | String | A URL that opens the item in the browser on the OneDrive website. |
site
Property | Type | Description |
---|---|---|
createdDateTime | DateTimeOffset | The date and time the item was created. Read-only. |
description | string | The descriptive text for the site. |
displayName | string | The full title for the site. Read-only. |
eTag | string | ETag for the item. Read-only. |
id | string | The unique identifier of the item. Read-only. |
lastModifiedDateTime | DateTimeOffset | The date and time the item was last modified. Read-only. |
name | string | The name / title of the item. |
root | root | If present, indicates that this is the root site in the site collection. Read-only. |
sharepointIds | sharepointIds | Returns identifiers useful for SharePoint REST compatibility. Read-only. |
siteCollection | siteCollection | Provides details about the site's site collection. Available only on the root site. Read-only. |
webUrl | string (url) | URL that displays the item in the browser. Read-only. |
sitePage
Property | Type | Description |
---|---|---|
contentType | contentTypeInfo | Inherited from baseItem. |
createdBy | identitySet | Inherited from baseItem. |
createdDateTime | DateTimeOffset | Inherited from baseItem. |
description | String | Inherited from baseItem. |
eTag | String | Inherited from baseItem. |
id | String | Inherited from entity. |
lastModifiedBy | identitySet | Inherited from baseItem. |
lastModifiedDateTime | DateTimeOffset | Inherited from baseItem. |
name | String | Inherited from baseItem. |
pageLayout | pageLayoutType | The name of the page layout of the page. The possible values are: microsoftReserved , article , home , unknownFutureValue . |
parentReference | itemReference | Inherited from baseItem. |
promotionKind | pagePromotionType | Indicates the promotion kind of the sitePage. The possible values are: microsoftReserved , page , newsPost , unknownFutureValue . |
publishingState | publicationFacet | The publishing status and the MM.mm version of the page. |
reactions | reactionsFacet | Reactions information for the page. |
showComments | Boolean | Determines whether or not to show comments at the bottom of the page. |
showRecommendedPages | Boolean | Determines whether or not to show recommended pages at the bottom of the page. |
thumbnailWebUrl | String | Url of the sitePage's thumbnail image |
title | String | Title of the sitePage. |
titleArea | titleArea | Title area on the SharePoint page. |
webUrl | String | Inherited from baseItem. |
subscription
Property | Type | Description |
---|---|---|
applicationId | String | Optional. Identifier of the application used to create the subscription. Read-only. |
changeType | String | Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported values are: created , updated , deleted . Multiple values can be combined using a comma-separated list. Note: updated changeType. updated and deleted changeType. Use updated to receive notifications when user or group is created, updated or soft deleted. Use deleted to receive notifications when user or group is permanently deleted. |
clientState | String | Optional. Specifies the value of the clientState property sent by the service in each change notification. The maximum length is 128 characters. The client can check that the change notification came from the service by comparing the value of the clientState property sent with the subscription with the value of the clientState property received with each change notification. |
creatorId | String | Optional. Identifier of the user or service principal that created the subscription. If the app used delegated permissions to create the subscription, this field contains the id of the signed-in user the app called on behalf of. If the app used application permissions, this field contains the id of the service principal corresponding to the app. Read-only. |
encryptionCertificate | String | Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Optional but required when includeResourceData is true . |
encryptionCertificateId | String | Optional. A custom app-provided identifier to help identify the certificate needed to decrypt resource data. |
expirationDateTime | DateTimeOffset | Required. Specifies the date and time when the webhook subscription expires. The time is in UTC, and can be an amount of time from subscription creation that varies for the resource subscribed to. For the maximum supported subscription length of time, see the table below. |
id | String | Optional. Unique identifier for the subscription. Read-only. |
includeResourceData | Boolean | Optional. When set to true , change notifications include resource data (such as content of a chat message). |
latestSupportedTlsVersion | String | Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by notificationUrl, supports. The possible values are: v1_0 , v1_1 , v1_2 , v1_3 . For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these subscribers, not setting this property per the timeline would result in subscription operations failing. For subscribers whose notification endpoint already supports TLS 1.2, setting this property is optional. In such cases, Microsoft Graph defaults the property to v1_2 . |
lifecycleNotificationUrl | String | Optional. The URL of the endpoint that receives lifecycle notifications, including subscriptionRemoved , reauthorizationRequired , and missed notifications. This URL must make use of the HTTPS protocol. |
notificationQueryOptions | String | Optional. OData query options for specifying value for the targeting resource. Clients receive notifications when resource reaches the state matching the query options provided here. With this new property in the subscription creation payload along with all existing properties, Webhooks will deliver notifications whenever a resource reaches the desired state mentioned in the notificationQueryOptions property. For example, when the print job is completed or when a print job resource isFetchable property value becomes true etc. Supported only for Universal Print Service. For more information, see Subscribe to change notifications from cloud printing APIs using Microsoft Graph. |
notificationUrl | String | Required. The URL of the endpoint that will receive the change notifications. This URL must make use of the HTTPS protocol. |
notificationUrlAppId | String | Optional. The app ID that the subscription service can use to generate the validation token. This allows the client to validate the authenticity of the notification received. |
resource | String | Required. Specifies the resource that will be monitored for changes. Do not include the base URL (https://graph.microsoft.com/v1.0/ ). See the possible resource path values for each supported resource. |
systemfacet
Thumbnail
Property | Type | Description |
---|---|---|
content | Stream | The content stream for the thumbnail. |
height | Int32 | The height of the thumbnail, in pixels. |
sourceItemId | String | The unique identifier of the item that provided the thumbnail. This is only available when a folder thumbnail is requested. |
url | String | The URL used to fetch the thumbnail content. |
width | Int32 | The width of the thumbnail, in pixels. |
ThumbnailSet
Property | Type | Description |
---|---|---|
id | String | The id within the item. Read-only. |
large | Thumbnail | A 1920x1920 scaled thumbnail. |
medium | Thumbnail | A 176x176 scaled thumbnail. |
small | Thumbnail | A 48x48 cropped thumbnail. |
source | Thumbnail | A custom thumbnail image or the original image used to generate other thumbnails. |
uploadSession
Property | Type | Description |
---|---|---|
expirationDateTime | DateTimeOffset | The date and time in UTC that the upload session will expire. The complete file must be uploaded before this expiration time is reached. |
nextExpectedRanges | String collection | A collection of byte ranges that the server is missing for the file. These ranges are zero indexed and of the format "start-end" (e.g. "0-26" to indicate the first 27 bytes of the file). When uploading files as Outlook attachments, instead of a collection of ranges, this property always indicates a single value "{start}", the location in the file where the next upload should begin. |
uploadUrl | String | The URL endpoint that accepts PUT requests for byte ranges of the file. |
workbookNamedItem
Property | Type | Description |
---|---|---|
name | string | The name of the object. Read-only. |
comment | string | Represents the comment associated with this name. |
scope | string | Indicates whether the name is scoped to the workbook or to a specific worksheet. Read-only. |
type | string | Indicates what type of reference is associated with the name. Possible values are: String , Integer , Double , Boolean , Range . Read-only. |
value | string | Represents the formula that the name is defined to refer to. E.g. =Sheet14!$B$2:$H$12, =4.75, etc. Read-only. |
visible | boolean | Specifies whether the object is visible or not. |