Microsoft Graph · Schema

microsoft.graph.driveItem

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name Type Description
audio object Audio metadata, if the item is an audio file. Read-only. Read-only. Only on OneDrive Personal.
bundle object Bundle metadata, if the item is a bundle. Read-only.
content string The content stream, if the item represents a file.
cTag string An eTag for the content of the item. This eTag isn't changed if only the metadata is changed. Note This property isn't returned if the item is a folder. Read-only.
deleted object Information about the deleted state of the item. Read-only.
file object File metadata, if the item is a file. Read-only.
fileSystemInfo object File system information on client. Read-write.
folder object Folder metadata, if the item is a folder. Read-only.
image object Image metadata, if the item is an image. Read-only.
location object Location metadata, if the item has location data. Read-only.
malware object Malware metadata, if the item was detected to contain malware. Read-only.
package object 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.
pendingOperations object If present, indicates that one or more operations that might affect the state of the driveItem are pending completion. Read-only.
photo object Photo metadata, if the item is a photo. Read-only.
publication object Provides information about the published or checked-out state of an item, in locations that support such actions. This property isn't returned by default. Read-only.
remoteItem object Remote item data, if the item is shared from a drive other than the one being accessed. Read-only.
root object If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive.
searchResult object Search metadata, if the item is from a search result. Read-only.
shared object Indicates that the item was shared with others and provides information about the shared state of the item. Read-only.
sharepointIds object Returns identifiers useful for SharePoint REST compatibility. Read-only.
size number Size of the item in bytes. Read-only.
specialFolder object If the current item is also available as a special folder, this facet is returned. Read-only.
video object Video metadata, if the item is a video. Read-only.
webDavUrl string WebDAV compatible URL for the item.
analytics object Analytics about the view activities that took place on this item.
children array Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.
listItem object For drives in SharePoint, the associated document library list item. Read-only. Nullable.
permissions array The set of permissions for the item. Read-only. Nullable.
retentionLabel object Information about retention label and settings enforced on the driveItem. Read-write.
subscriptions array The set of subscriptions on the item. Only supported on the root of a drive.
thumbnails array Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.
versions array The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.
workbook object For files that are Excel spreadsheets, access to the workbook API to work with the spreadsheet's contents. Nullable.
@odata.type string
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphdriveitem-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.driveItem",
  "title": "microsoft.graph.driveItem",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.baseItem"
    },
    {
      "title": "driveItem",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "audio": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.audio"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Audio metadata, if the item is an audio file. Read-only. Read-only. Only on OneDrive Personal."
        },
        "bundle": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.bundle"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Bundle metadata, if the item is a bundle. Read-only."
        },
        "content": {
          "type": "string",
          "description": "The content stream, if the item represents a file.",
          "format": "base64url",
          "nullable": true
        },
        "cTag": {
          "type": "string",
          "description": "An eTag for the content of the item. This eTag isn't changed if only the metadata is changed. Note This property isn't returned if the item is a folder. Read-only.",
          "nullable": true
        },
        "deleted": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.deleted"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Information about the deleted state of the item. Read-only."
        },
        "file": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.file"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "File metadata, if the item is a file. Read-only."
        },
        "fileSystemInfo": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.fileSystemInfo"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "File system information on client. Read-write."
        },
        "folder": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.folder"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Folder metadata, if the item is a folder. Read-only."
        },
        "image": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.image"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Image metadata, if the item is an image. Read-only."
        },
        "location": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.geoCoordinates"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Location metadata, if the item has location data. Read-only."
        },
        "malware": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.malware"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Malware metadata, if the item was detected to contain malware. Read-only."
        },
        "package": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.package"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "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."
        },
        "pendingOperations": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.pendingOperations"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "If present, indicates that one or more operations that might affect the state of the driveItem are pending completion. Read-only."
        },
        "photo": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.photo"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Photo metadata, if the item is a photo. Read-only."
        },
        "publication": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.publicationFacet"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Provides information about the published or checked-out state of an item, in locations that support such actions. This property isn't returned by default. Read-only."
        },
        "remoteItem": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.remoteItem"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Remote item data, if the item is shared from a drive other than the one being accessed. Read-only."
        },
        "root": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.root"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive."
        },
        "searchResult": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.searchResult"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Search metadata, if the item is from a search result. Read-only."
        },
        "shared": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.shared"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Indicates that the item was shared with others and provides information about the shared state of the item. Read-only."
        },
        "sharepointIds": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.sharepointIds"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Returns identifiers useful for SharePoint REST compatibility. Read-only."
        },
        "size": {
          "type": "number",
          "description": "Size of the item in bytes. Read-only.",
          "format": "int64",
          "nullable": true
        },
        "specialFolder": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.specialFolder"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "If the current item is also available as a special folder, this facet is returned. Read-only."
        },
        "video": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.video"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Video metadata, if the item is a video. Read-only."
        },
        "webDavUrl": {
          "type": "string",
          "description": "WebDAV compatible URL for the item.",
          "nullable": true
        },
        "analytics": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.itemAnalytics"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Analytics about the view activities that took place on this item.",
          "x-ms-navigationProperty": true
        },
        "children": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.driveItem"
          },
          "description": "Collection containing Item objects for the immediate children of Item. Only items representing folders have children. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "listItem": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.listItem"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "For drives in SharePoint, the associated document library list item. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "permissions": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.permission"
          },
          "description": "The set of permissions for the item. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "retentionLabel": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.itemRetentionLabel"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Information about retention label and settings enforced on the driveItem. Read-write.",
          "x-ms-navigationProperty": true
        },
        "subscriptions": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.subscription"
          },
          "description": "The set of subscriptions on the item. Only supported on the root of a drive.",
          "x-ms-navigationProperty": true
        },
        "thumbnails": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.thumbnailSet"
          },
          "description": "Collection of thumbnailSet objects associated with the item. For more information, see getting thumbnails. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "versions": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.driveItemVersion"
          },
          "description": "The list of previous versions of the item. For more info, see getting previous versions. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "workbook": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.workbook"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "For files that are Excel spreadsheets, access to the workbook API to work with the spreadsheet's contents. Nullable.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string",
          "default": "#microsoft.graph.driveItem"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.driveItem"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphdriveitem"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.