microsoft.graph.onenote

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/microsoft-onenote/json-schema/microsoft-onenote-microsoft-graph-onenote-schema.json",
  "title": "microsoft.graph.onenote",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/microsoft-onenote-openapi.yml#/components/schemas/microsoft.graph.onenote",
  "allOf": [
    {
      "$ref": "#/$defs/microsoft.graph.entity"
    },
    {
      "title": "onenote",
      "type": "object",
      "properties": {
        "notebooks": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.notebook"
          },
          "description": "The collection of OneNote notebooks that are owned by the user or group. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "operations": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.onenoteOperation"
          },
          "description": "The status of OneNote operations. Getting an operations collection isn't supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "pages": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.onenotePage"
          },
          "description": "The pages in all OneNote notebooks that are owned by the user or group.  Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "resources": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.onenoteResource"
          },
          "description": "The image and other file resources in OneNote pages. Getting a resources collection isn't supported, but you can get the binary content of a specific resource. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "sectionGroups": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.sectionGroup"
          },
          "description": "The section groups in all OneNote notebooks that are owned by the user or group.  Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "sections": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/microsoft.graph.onenoteSection"
          },
          "description": "The sections in all OneNote notebooks that are owned by the user or group.  Read-only. Nullable.",
          "x-ms-navigationProperty": true
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    }
  ],
  "$defs": {
    "microsoft.graph.entity": {
      "title": "entity",
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The unique identifier for an entity. Read-only."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.externalLink": {
      "title": "externalLink",
      "type": "object",
      "properties": {
        "href": {
          "type": [
            "string",
            "null"
          ],
          "description": "The URL of the link."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.identity": {
      "title": "identity",
      "type": "object",
      "properties": {
        "displayName": {
          "type": [
            "string",
            "null"
          ],
          "description": "The display name of the identity.For drive items, the display name might not always be available or up to date. For example, if a user changes their display name the API might show the new value in a future response, but the items associated with the user don't show up as changed when using delta."
        },
        "id": {
          "type": [
            "string",
            "null"
          ],
          "description": "Unique identifier for the identity or actor. For example, in the access reviews decisions API, this property might record the id of the principal, that is, the group, user, or application that's subject to review."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.identitySet": {
      "title": "identitySet",
      "type": "object",
      "properties": {
        "application": {
          "$ref": "#/$defs/microsoft.graph.identity"
        },
        "device": {
          "$ref": "#/$defs/microsoft.graph.identity"
        },
        "user": {
          "$ref": "#/$defs/microsoft.graph.identity"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.notebook": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntityHierarchyModel"
        },
        {
          "title": "notebook",
          "type": "object",
          "properties": {
            "isDefault": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indicates whether this is the user's default notebook. Read-only."
            },
            "isShared": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indicates whether the notebook is shared. If true, the contents of the notebook can be seen by people other than the owner. Read-only."
            },
            "links": {
              "$ref": "#/$defs/microsoft.graph.notebookLinks"
            },
            "sectionGroupsUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for the sectionGroups navigation property, which returns all the section groups in the notebook. Read-only."
            },
            "sectionsUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for the sections navigation property, which returns all the sections in the notebook. Read-only."
            },
            "userRole": {
              "$ref": "#/$defs/microsoft.graph.onenoteUserRole"
            },
            "sectionGroups": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.sectionGroup"
              },
              "description": "The section groups in the notebook. Read-only. Nullable.",
              "x-ms-navigationProperty": true
            },
            "sections": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.onenoteSection"
              },
              "description": "The sections in the notebook. Read-only. Nullable.",
              "x-ms-navigationProperty": true
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.notebookLinks": {
      "title": "notebookLinks",
      "type": "object",
      "properties": {
        "oneNoteClientUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        },
        "oneNoteWebUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.onenoteEntityBaseModel": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "onenoteEntityBaseModel",
          "type": "object",
          "properties": {
            "self": {
              "type": [
                "string",
                "null"
              ],
              "description": "The endpoint where you can get details about the page. Read-only."
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteEntityHierarchyModel": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntitySchemaObjectModel"
        },
        {
          "title": "onenoteEntityHierarchyModel",
          "type": "object",
          "properties": {
            "createdBy": {
              "$ref": "#/$defs/microsoft.graph.identitySet"
            },
            "displayName": {
              "type": [
                "string",
                "null"
              ],
              "description": "The name of the notebook."
            },
            "lastModifiedBy": {
              "$ref": "#/$defs/microsoft.graph.identitySet"
            },
            "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": "The date and time when the notebook was last modified. The timestamp 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"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteEntitySchemaObjectModel": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntityBaseModel"
        },
        {
          "title": "onenoteEntitySchemaObjectModel",
          "type": "object",
          "properties": {
            "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 date and time when the page was created. The timestamp 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"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteOperation": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.operation"
        },
        {
          "title": "onenoteOperation",
          "type": "object",
          "properties": {
            "error": {
              "$ref": "#/$defs/microsoft.graph.onenoteOperationError"
            },
            "percentComplete": {
              "type": [
                "string",
                "null"
              ],
              "description": "The operation percent complete if the operation is still in running status."
            },
            "resourceId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The resource id."
            },
            "resourceLocation": {
              "type": [
                "string",
                "null"
              ],
              "description": "The resource URI for the object. For example, the resource URI for a copied page or section."
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteOperationError": {
      "title": "onenoteOperationError",
      "type": "object",
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ],
          "description": "The error code."
        },
        "message": {
          "type": [
            "string",
            "null"
          ],
          "description": "The error message."
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.onenotePage": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntitySchemaObjectModel"
        },
        {
          "title": "onenotePage",
          "type": "object",
          "properties": {
            "content": {
              "type": [
                "string",
                "null"
              ],
              "description": "The page's HTML content.",
              "format": "base64url"
            },
            "contentUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for the page's HTML content.  Read-only."
            },
            "createdByAppId": {
              "type": [
                "string",
                "null"
              ],
              "description": "The unique identifier of the application that created the page. Read-only."
            },
            "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": "The date and time when the page was last modified. The timestamp 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"
            },
            "level": {
              "maximum": 2147483647,
              "minimum": -2147483648,
              "type": [
                "number",
                "null"
              ],
              "description": "The indentation level of the page. Read-only.",
              "format": "int32"
            },
            "links": {
              "$ref": "#/$defs/microsoft.graph.pageLinks"
            },
            "order": {
              "maximum": 2147483647,
              "minimum": -2147483648,
              "type": [
                "number",
                "null"
              ],
              "description": "The order of the page within its parent section. Read-only.",
              "format": "int32"
            },
            "title": {
              "type": [
                "string",
                "null"
              ],
              "description": "The title of the page."
            },
            "userTags": {
              "type": "array",
              "items": {
                "type": [
                  "string",
                  "null"
                ]
              }
            },
            "parentNotebook": {
              "$ref": "#/$defs/microsoft.graph.notebook"
            },
            "parentSection": {
              "$ref": "#/$defs/microsoft.graph.onenoteSection"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteResource": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntityBaseModel"
        },
        {
          "title": "onenoteResource",
          "type": "object",
          "properties": {
            "content": {
              "type": [
                "string",
                "null"
              ],
              "description": "The content stream",
              "format": "base64url"
            },
            "contentUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for downloading the content"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteSection": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntityHierarchyModel"
        },
        {
          "title": "onenoteSection",
          "type": "object",
          "properties": {
            "isDefault": {
              "type": [
                "boolean",
                "null"
              ],
              "description": "Indicates whether this is the user's default section. Read-only."
            },
            "links": {
              "$ref": "#/$defs/microsoft.graph.sectionLinks"
            },
            "pagesUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The pages endpoint where you can get details for all the pages in the section. Read-only."
            },
            "pages": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.onenotePage"
              },
              "description": "The collection of pages in the section.  Read-only. Nullable.",
              "x-ms-navigationProperty": true
            },
            "parentNotebook": {
              "$ref": "#/$defs/microsoft.graph.notebook"
            },
            "parentSectionGroup": {
              "$ref": "#/$defs/microsoft.graph.sectionGroup"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.onenoteUserRole": {
      "title": "onenoteUserRole",
      "enum": [
        "None",
        "Owner",
        "Contributor",
        "Reader"
      ],
      "type": "string"
    },
    "microsoft.graph.operation": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.entity"
        },
        {
          "title": "operation",
          "type": "object",
          "properties": {
            "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 start time of the operation.",
              "format": "date-time"
            },
            "lastActionDateTime": {
              "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 of the last action of the operation.",
              "format": "date-time"
            },
            "status": {
              "$ref": "#/$defs/microsoft.graph.operationStatus"
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.operationStatus": {
      "title": "operationStatus",
      "enum": [
        "NotStarted",
        "Running",
        "Completed",
        "Failed"
      ],
      "type": "string"
    },
    "microsoft.graph.pageLinks": {
      "title": "pageLinks",
      "type": "object",
      "properties": {
        "oneNoteClientUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        },
        "oneNoteWebUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    },
    "microsoft.graph.sectionGroup": {
      "allOf": [
        {
          "$ref": "#/$defs/microsoft.graph.onenoteEntityHierarchyModel"
        },
        {
          "title": "sectionGroup",
          "type": "object",
          "properties": {
            "sectionGroupsUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for the sectionGroups navigation property, which returns all the section groups in the section group. Read-only."
            },
            "sectionsUrl": {
              "type": [
                "string",
                "null"
              ],
              "description": "The URL for the sections navigation property, which returns all the sections in the section group. Read-only."
            },
            "parentNotebook": {
              "$ref": "#/$defs/microsoft.graph.notebook"
            },
            "parentSectionGroup": {
              "$ref": "#/$defs/microsoft.graph.sectionGroup"
            },
            "sectionGroups": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.sectionGroup"
              },
              "description": "The section groups in the section. Read-only. Nullable.",
              "x-ms-navigationProperty": true
            },
            "sections": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/microsoft.graph.onenoteSection"
              },
              "description": "The sections in the section group. Read-only. Nullable.",
              "x-ms-navigationProperty": true
            }
          },
          "additionalProperties": {
            "type": "object"
          }
        }
      ]
    },
    "microsoft.graph.sectionLinks": {
      "title": "sectionLinks",
      "type": "object",
      "properties": {
        "oneNoteClientUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        },
        "oneNoteWebUrl": {
          "$ref": "#/$defs/microsoft.graph.externalLink"
        }
      },
      "additionalProperties": {
        "type": "object"
      }
    }
  }
}