Microsoft OneDrive · Schema

microsoft.graph.driveItem

Cloud StorageFile StorageFileMicrosoftMicrosoft 365

Properties

Name Type Description
id string The unique identifier for an entity. Read-only.
@odata.type string
createdBy object Identity of the user, device, or application that created the item. Read-only.
createdDateTime string Date and time of item creation. Read-only.
description stringnull Provides a user-visible description of the item. Optional.
eTag stringnull ETag for the item. Read-only.
lastModifiedBy object Identity of the user, device, and application that last modified the item. Read-only.
lastModifiedDateTime string Date and time the item was last modified. Read-only.
name stringnull The name of the item. Read-write.
parentReference object Parent information, if the item has a parent. Read-write.
webUrl stringnull URL that either displays the resource in the browser (for Office file formats), or is a direct link to the file (for other formats). Read-only.
createdByUser object Identity of the user who created the item. Read-only.
lastModifiedByUser object Identity of the user who last modified the item. Read-only.
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 stringnull The content stream, if the item represents a file.
cTag stringnull 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 numbernull 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 stringnull 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.
View JSON Schema on GitHub

JSON Schema

microsoft-onedrive-microsoft-graph-drive-item-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-onedrive/json-schema/microsoft-onedrive-microsoft-graph-drive-item-schema.json",
  "title": "microsoft.graph.driveItem",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-onedrive-drives-drive-functions-api-openapi.yml#/components/schemas/microsoft.graph.driveItem",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.baseItem"
    },
    {
      "title": "driveItem",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "audio": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.audio"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Audio metadata, if the item is an audio file. Read-only. Read-only. Only on OneDrive Personal."
        },
        "bundle": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.bundle"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Bundle metadata, if the item is a bundle. Read-only."
        },
        "content": {
          "type": [
            "string",
            "null"
          ],
          "description": "The content stream, if the item represents a file.",
          "format": "base64url"
        },
        "cTag": {
          "type": [
            "string",
            "null"
          ],
          "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."
        },
        "deleted": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.deleted"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Information about the deleted state of the item. Read-only."
        },
        "file": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.file"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "File metadata, if the item is a file. Read-only."
        },
        "fileSystemInfo": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.fileSystemInfo"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "File system information on client. Read-write."
        },
        "folder": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.folder"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Folder metadata, if the item is a folder. Read-only."
        },
        "image": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.image"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Image metadata, if the item is an image. Read-only."
        },
        "location": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.geoCoordinates"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Location metadata, if the item has location data. Read-only."
        },
        "malware": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.malware"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Malware metadata, if the item was detected to contain malware. Read-only."
        },
        "package": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.package"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "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": "#/$defs/microsoft.graph.pendingOperations"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "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": "#/$defs/microsoft.graph.photo"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Photo metadata, if the item is a photo. Read-only."
        },
        "publication": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.publicationFacet"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "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": "#/$defs/microsoft.graph.remoteItem"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Remote item data, if the item is shared from a drive other than the one being accessed. Read-only."
        },
        "root": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.root"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "If this property is non-null, it indicates that the driveItem is the top-most driveItem in the drive."
        },
        "searchResult": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.searchResult"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Search metadata, if the item is from a search result. Read-only."
        },
        "shared": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.shared"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Indicates that the item was shared with others and provides information about the shared state of the item. Read-only."
        },
        "sharepointIds": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.sharepointIds"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Returns identifiers useful for SharePoint REST compatibility. Read-only."
        },
        "size": {
          "type": [
            "number",
            "null"
          ],
          "description": "Size of the item in bytes. Read-only.",
          "format": "int64"
        },
        "specialFolder": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.specialFolder"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "If the current item is also available as a special folder, this facet is returned. Read-only."
        },
        "video": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.video"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Video metadata, if the item is a video. Read-only."
        },
        "webDavUrl": {
          "type": [
            "string",
            "null"
          ],
          "description": "WebDAV compatible URL for the item."
        },
        "analytics": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.itemAnalytics"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Analytics about the view activities that took place on this item.",
          "x-ms-navigationProperty": true
        },
        "children": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/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": "#/$defs/microsoft.graph.listItem"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "For drives in SharePoint, the associated document library list item. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "permissions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.permission"
          },
          "description": "The set of permissions for the item. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "retentionLabel": {
          "anyOf": [
            {
              "$ref": "#/$defs/microsoft.graph.itemRetentionLabel"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "description": "Information about retention label and settings enforced on the driveItem. Read-write.",
          "x-ms-navigationProperty": true
        },
        "subscriptions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/microsoft.graph.workbook"
            },
            {
              "type": [
                "object",
                "null"
              ]
            }
          ],
          "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",
  "$defs": {
    "ReferenceNumeric": {
      "enum": [
        "-INF",
        "INF",
        "NaN",
        null
      ],
      "type": [
        "string",
        "null"
      ]
    },
    "microsoft.graph.accessAction": {
      "title": "accessAction",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.actionState": {
      "title": "actionState",
      "enum": [
        "none",
        "pending",
        "canceled",
        "active",
        "done",
        "failed",
        "notSupported"
      ],
      "type": "string",
      "description": "State of the action on the device",
      "x-ms-enum": {
        "name": "actionState",
        "modelAsString": false,
        "values": [
          {
            "value": "none",
            "description": "Not a valid action state",
            "name": "none"
          },
          {
            "value": "pending",
            "description": "Action is pending",
            "name": "pending"
          },
          {
            "value": "canceled",
            "description": "Action has been cancelled.",
            "name": "canceled"
          },
          {
            "value": "active",
            "description": "Action is active.",
            "name": "active"
          },
          {
            "value": "done",
            "description": "Action completed without errors.",
            "name": "done"
          },
          {
            "value": "failed",
            "description": "Action failed",
            "name": "failed"
          },
          {
            "value": "notSupported",
            "description": "Action is not supported.",
            "name": "notSupported"
          }
        ]
      }
    },
    "microsoft.graph.activitiesContainer": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "activitiesContainer",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "contentActivities": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.contentActivity"
              },
              "description": "Collection of activity logs related to content processing.",
              "x-ms-navigationProperty": true
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.activitiesContainer"
    },
    "microsoft.graph.activityHistoryItem": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "activityHistoryItem",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "activeDurationSeconds": {
              "maximum": 2147483647,
              "minimum": -2147483648,
              "type": [
                "number",
                "null"
              ],
              "description": "Optional. The duration of active user engagement. if not supplied, this is calculated from the startedDateTime and lastActiveDateTime.",
              "format": "int32"
            },
            "createdDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "Set by the server. DateTime in UTC when the object was created on the server.",
              "format": "date-time"
            },
            "expirationDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "Optional. UTC DateTime when the activityHistoryItem will undergo hard-delete. Can be set by the client.",
              "format": "date-time"
            },
            "lastActiveDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "Optional. UTC DateTime when the activityHistoryItem (activity session) was last understood as active or finished - if null, activityHistoryItem status should be Ongoing.",
              "format": "date-time"
            },
            "lastModifiedDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "Set by the server. DateTime in UTC when the object was modified on the server.",
              "format": "date-time"
            },
            "startedDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": "string",
              "description": "Required. UTC DateTime when the activityHistoryItem (activity session) was started. Required for timeline history.",
              "format": "date-time"
            },
            "status": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.status"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "Set by the server. A status code used to identify valid objects. Values: active, updated, deleted, ignored."
            },
            "userTimezone": {
              "type": [
                "string",
                "null"
              ],
              "description": "Optional. The timezone in which the user's device used to generate the activity was located at activity creation time. Values supplied as Olson IDs in order to support cross-platform representation."
            },
            "activity": {
              "$ref": "#/$defs/microsoft.graph.userActivity"
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.activityHistoryItem"
    },
    "microsoft.graph.activityMetadata": {
      "title": "activityMetadata",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "activity": {
          "$ref": "#/$defs/microsoft.graph.userActivityType"
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.adhocCall": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "adhocCall",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "recordings": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.callRecording"
              },
              "description": "The recordings of a call. Read-only.",
              "x-ms-navigationProperty": true
            },
            "transcripts": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.callTranscript"
              },
              "description": "The transcripts of a call. Read-only.",
              "x-ms-navigationProperty": true
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.adhocCall"
    },
    "microsoft.graph.agreementAcceptance": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "agreementAcceptance",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "agreementFileId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The identifier of the agreement file accepted by the user."
            },
            "agreementId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The identifier of the agreement."
            },
            "deviceDisplayName": {
              "type": [
                "string",
                "null"
              ],
              "description": "The display name of the device used for accepting the agreement."
            },
            "deviceId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The unique identifier of the device used for accepting the agreement. Supports $filter (eq) and eq for null values."
            },
            "deviceOSType": {
              "type": [
                "string",
                "null"
              ],
              "description": "The operating system used to accept the agreement."
            },
            "deviceOSVersion": {
              "type": [
                "string",
                "null"
              ],
              "description": "The operating system version of the device used to accept the agreement."
            },
            "expirationDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "The expiration date time of the acceptance. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Supports $filter (eq, ge, le) and eq for null values.",
              "format": "date-time"
            },
            "recordedDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.",
              "format": "date-time"
            },
            "state": {
              "anyOf": [
                {
                  "$ref": "#/$defs/microsoft.graph.agreementAcceptanceState"
                },
                {
                  "type": [
                    "object",
                    "null"
                  ]
                }
              ],
              "description": "The state of the agreement acceptance. The possible values are: accepted, declined. Supports $filter (eq)."
            },
            "userDisplayName": {
              "type": [
                "string",
                "null"
              ],
              "description": "Display name of the user when the acceptance was recorded."
            },
            "userEmail": {
              "type": [
                "string",
                "null"
              ],
              "description": "Email of the user when the acceptance was recorded."
            },
            "userId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The identifier of the user who accepted the agreement. Supports $filter (eq)."
            },
            "userPrincipalName": {
              "type": [
                "string",
                "null"
              ],
              "description": "UPN of the user when the acceptance was recorded."
            },
            "@odata.type": {
              "type": "string"
            }
          }
        }
      ],
      "x-ms-discriminator-value": "#microsoft.graph.agreementAcceptance"
    },
    "microsoft.graph.agreementAcceptanceState": {
      "title": "agreementAcceptanceState",
      "enum": [
        "accepted",
        "declined",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.album": {
      "title": "album",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "coverImageItemId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unique identifier of the driveItem that is the cover of the album."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.allowedLobbyAdmitterRoles": {
      "title": "allowedLobbyAdmitterRoles",
      "enum": [
        "organizerAndCoOrganizersAndPresenters",
        "organizerAndCoOrganizers",
        "unknownFutureValue"
      ],
      "type": "string"
    },
    "microsoft.graph.alternativeSecurityId": {
      "title": "alternativeSecurityId",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "identityProvider": {
          "type": [
            "string",
            "null"
          ],
          "description": "For internal use only."
        },
        "key": {
          "type": [
            "string",
            "null"
          ],
          "description": "For internal use only.",
          "format": "base64url"
        },
        "type": {
          "maximum": 2147483647,
          "minimum": -2147483648,
          "type": [
            "number",
            "null"
          ],
          "description": "For internal use only.",
          "format": "int32"
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.appIdentity": {
      "title": "appIdentity",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "appId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Refers to the unique ID representing application in Microsoft Entra ID."
        },
        "displayName": {
          "type": [
            "string",
            "null"
          ],
          "description": "Refers to the application name displayed in the Microsoft Entra admin center."
        },
        "servicePrincipalId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Refers to the unique ID for the service principal in Microsoft Entra ID."
        },
        "servicePrincipalName": {
          "type": [
            "string",
            "null"
          ],
          "description": "Refers to the Service Principal Name is the Application name in the tenant."
        },
        "@odata.type": {
          "type": "string"
        }
      }
    },
    "microsoft.graph.appLogUploadState": {
      "title": "appLogUploadState",
      "enum": [
        "pending",
        "completed",
        "failed",
        "unknownFutureValue"
      ],
      "type": "string",
      "description": "AppLogUploadStatus",
      "x-ms-enum": {
        "name": "appLogUploadState",
        "modelAsString": false,
        "values": [
          {
            "value": "pending",
            "description": "Default. Indicates that request is waiting to be processed or under processing.",
            "name": "pending"
          },
          {
            "value": "completed",
            "description": "Indicates that request is completed with file uploaded to Azure blob for download.",
            "name": "completed"
          },
          {
            "value": "failed",
            "description": "Indicates that request is completed with file uploaded to Azure blob for download.",
            "name": "failed"
          },
          {
            "value": "unknownFutureValue",
            "description": "Evolvable enumeration sentinel value. Do not use.",
            "name": "unknownFutureValue"
          }
        ]
      }
    },
    "microsoft.graph.appRoleAssignment": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.directoryObject"
        },
        {
          "title": "appRoleAssignment",
          "required": [
            "@odata.type"
          ],
          "type": "object",
          "properties": {
            "appRoleId": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": "string",
              "description": "The identifier (id) for the app role that's assigned to the principal. This app role must be exposed in the appRoles property on the resource application's service principal (resourceId). If the resource application hasn't declared any app roles, a default app role ID of 00000000-0000-0000-0000-000000000000 can be specified to signal that the principal is assigned to the resource app without any specific app roles. Required on create.",
              "format": "uuid"
            },
            "createdDateTime": {
              "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
              "type": [
                "string",
                "null"
              ],
              "description": "The time when the app role assignment was created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.",
              "format": "date-time"
            },
            "principalDisplayName": {
              "type": [
                "string",
                "null"
              ],
              "description": "The display name of the user, group, or service principal that was granted the app role assignment. Maximum length is 256 characters. Read-only. Supports $filter (eq and startswith)."
            },
            "principalId": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": [
                "string",
                "null"
              ],
              "description": "The unique identifier (id) for the user, security group, or service principal being granted the app role. Security groups with dynamic memberships are supported. Required on create.",
              "format": "uuid"
            },
            "principalType": {
              "type": [
                "string",
                "null"
              ],
              "description": "The type of the assigned principal. This can either be User, Group, or ServicePrincipal. Read-only."
            },
            "resourceDisplayName": {
              "type": [
                "string",
                "null"
              ],
              "description": "The display name of the resource app's service principal to which the assignment is made. Maximum length is 256 characters."
            },
            "resourceId": {
              "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
              "type": [
                "string",
                "null"
              ],
              "description": "The unique identifier (id)

# --- truncated at 32 KB (1157 KB total) ---
# Full source: https://artifacts.apis.io/microsoft-onedrive/json-schema/microsoft-onedrive-microsoft-graph-drive-item-schema.json

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-onedrive-microsoft-graph-drive-item"
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.