Microsoft OneNote

Copies a OneNote notebook to the destination group's Documents library.

Copies a OneNote notebook within a SharePoint site.

Copies a site-hosted OneNote section to a notebook.

Copies a OneNote section to a specific notebook for a specified user. Use this action when you need to duplicate an existing OneNote section into a different notebook under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copies a OneNote section from a Microsoft 365 group's notebook into another section group. Use this action when you need to duplicate an existing OneNote section that lives in a Microsoft 365 group's notebook into a different section group. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copies a OneNote section to a specific section group for a specified user. Use this action when you need to duplicate an existing OneNote section into a different section group under a specific user's account. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. The copy is additive and does not remove the source section. Poll the returned Operation-Location value to determine the final outcome.

Copies a OneNote page to a section within a SharePoint site.

Start an asynchronous copy of a user OneNote notebook.

Copy a OneNote page from a user's notebook to a section.

Gets the provider-reported count of OneNote sections directly within a user's section group. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. This is a read-only operation.

Gets the provider-reported count of sections directly within a SharePoint site's OneNote section group. Use this action when you need to quickly determine the number of sections in a section group without retrieving the full list of section objects. Microsoft Graph requires the `ConsistencyLevel: eventual` header when using the `$count=true` query parameter on OneNote endpoints.

Create a section group inside another group OneNote section group.

Creates a new OneNote notebook within a Microsoft 365 group.

Creates a new OneNote page in the default section of the default notebook for a Microsoft 365 group. Use this action when you need to programmatically create a new page in a group's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.

Creates a new OneNote section within a specified section group of a Microsoft 365 group. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy within a group. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new OneNote notebook for the signed-in user. Use this action when you need to create a new personal notebook to organize notes. The notebook will be created in the user's default OneDrive for Business location. Notebook names must be unique, cannot exceed 128 characters, and cannot contain ? * / : < > | ' or ". Ampersands are allowed. Returns the full created notebook object including the server-assigned ID and URLs for accessing sections.

Creates a new OneNote section within a specified section group of a notebook for the signed-in user. Use this action when you need to add a new section to organize OneNote pages within a user's section group hierarchy. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new OneNote page in a specific section for the signed-in user. Use this action when you need to create a new page within a specific section of the user's OneNote notebook. The page content must be provided as HTML. The action constructs a complete HTML document including the title and optional creation timestamp in the meta tag. To include images or attachments, provide the full HTML with external image URLs, or use a multipart request approach. Repeated calls create separate pages, even when the title and content match.

Creates a new section group within a OneNote notebook that belongs to a Microsoft 365 group. Use this action when you need to organize sections inside a group notebook by creating a new top-level section group to hold related sections together. The displayName must be 50 characters or fewer and cannot contain the characters ? * / : < > | & # ' % ~. Section group names must be unique within the same hierarchy level in the notebook.

Create a section group inside another site OneNote section group.

Create a OneNote notebook in a SharePoint site.

Creates a new OneNote section within a specified notebook in a SharePoint site. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a SharePoint site. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. This action is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated/personal account), Notes.ReadWrite.All (application).

Create a section group inside another user OneNote section group.

Creates a new OneNote section within a specified notebook for a specific user. Use this action when you need to add a new section to organize OneNote pages within a notebook that belongs to a specific user. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Returns the full created section object including the server-assigned ID.

Creates a new OneNote page in the default section of the default notebook for a specific user. Use this action when you need to programmatically create a new page in a user's OneNote notebook. The page content must be provided as HTML. The page will be created in the default section of the default notebook unless a specific section name is provided via the sectionName query parameter.

Creates a new OneNote section within a specified section group for a specific user. Use this action when you need to add a new section to organize OneNote pages within a section group's hierarchy for a specific user's notebook. The section name must be unique within the same hierarchy level, cannot exceed 50 characters, and cannot contain the characters: ?*/:<>|&#''%~. Repeating the call with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

Creates a new OneNote page in a specific section of a user's notebook. Use this action when you need to create a new page directly in a section within a user's OneNote notebook. The page content must be provided as valid HTML with proper structure (html, head, and body tags). Calling this action multiple times creates separate pages.

Deletes a OneNote page within a Microsoft 365 group's OneNote workspace. Canonical action for this group page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply.

Delete a specific OneNote page from a section within a notebook in a group. Compatibility alias for deleting a group OneNote page. Prefer DeleteOnenoteGroupSectionGroupPageContent for new calls. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may apply.

Deletes a OneNote page from a SharePoint site. Use this action to delete a OneNote page from a SharePoint site's OneNote workspace. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply.

Deletes a OneNote page from a section within a section group in a user's notebook. Compatibility alias for deleting a user OneNote page. Prefer DeleteUserPages for new calls. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply. Use this action when you need to remove an unwanted page from a section in a user's OneNote notebook.

Deletes a OneNote page from a user's OneNote workspace. Canonical action for this user page deletion route. Microsoft Graph returns 204 No Content after accepting the deletion; OneNote retention policies may still apply. Use this action when you need to remove an unwanted OneNote page from a user's notebook that has been shared with the current user.

Retrieves a specific OneNote section from a Microsoft 365 group. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the group ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Retrieves the binary content of a specific OneNote resource using its ID. Use this action when you need to fetch the raw binary content of an image, file attachment, or other embedded resource from a OneNote page in the signed-in user's notebooks. The resource is identified by its unique resource_id, which can be obtained from page content URLs. Note: Binary content is returned as-is; images and files may need additional processing (e.g., base64 decoding or writing to a file) depending on your use case.

Retrieves the HTML content of a specific OneNote page from a section for the signed-in user. Use this action when you need to fetch the full HTML content of a OneNote page within a specific section. This endpoint provides access to page content for processing, rendering, or exporting page data. The returned HTML includes text, images, and other embedded content references. This action is read-only and does not modify any data.

Retrieves a OneNote notebook by using its web URL path. Use this action when you have the SharePoint or OneDrive URL of a notebook and need to retrieve its properties and metadata. The webUrl parameter accepts both standard HTTPS URLs and OneNote protocol URLs with the 'onenote:' prefix. This API is available in the following national cloud deployments: Global service only. Required permissions: Notes.Create (delegated) or Notes.Read.All (application).

Retrieves a specific section group from a OneNote notebook within a Microsoft 365 group. Use this action when you need to get details about a specific section group, including its name, creation/modification timestamps, and links to its sections and nested section groups.

Retrieves the status of a long-running OneNote operation for a group. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress.

Retrieves OneNote page metadata directly by page ID in a Microsoft 365 group. Legacy notebook, section group, and section IDs do not affect the Graph route.

Retrieves the status of a long-running OneNote operation for a SharePoint site. Use this action when you need to check whether a copy or sync operation (e.g., CopyNotebook, CopyToNotebook, CopyToSectionGroup, CopyToSection) has completed, failed, or is still in progress for a site.

Gets the HTML content of a specific OneNote page for a user. Use this action when you need to retrieve the actual HTML content of a specific OneNote page for reading, processing, or displaying page content. The action supports the includeIDs query parameter to include element IDs in the HTML, which is useful when preparing content for page updates via the PATCH endpoint.

Retrieves metadata and properties of a specific OneNote page from the authenticated user's notebooks. Use this action when you need to fetch details about a OneNote page by its ID without navigating the full notebook/section hierarchy. This returns page metadata including title, creation date, modification date, and optional expanded parent relationships. For retrieving the HTML content of a page, use the dedicated page content endpoint instead.

Retrieves a list of recently accessed OneNote notebooks for the signed-in user. Use this action when you need to display recently accessed notebooks, provide quick access to notebooks the user has been working with, or build a recent notebooks feature. The notebooks are returned in order of most recent access. Set includePersonalNotebooks to true to include notebooks owned by the user, or false to exclude them.

Retrieves a specific OneNote section by its ID from the current user's OneNote. Use this action when you need to fetch metadata or details for a single OneNote section by specifying only the section ID, without requiring additional context like group, user, or site IDs. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Retrieves a specific OneNote page from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote page by its page identifier within a SharePoint site. This action supports optional OData query parameters to select specific properties or expand related entities like parentSection and parentNotebook. Note: This action is read-only and does not modify any data. It is the canonical action for the site page metadata route.

Retrieves a text preview of a OneNote page directly by page ID in a SharePoint site.

Retrieves a specific OneNote section from a SharePoint site. Use this action when you need to fetch metadata or details for a single OneNote section by specifying the site ID and section ID. This action supports OData query parameters for selecting specific properties and expanding relationships like parentNotebook or parentSectionGroup.

Compatibility alias for retrieving OneNote page metadata directly by page ID in a SharePoint site. Prefer GetSiteOnenotePages for new calls. Legacy notebook, section group, and section IDs do not affect the Graph route.

Retrieves the properties and relationships of a OneNote notebook by ID for a specific user. Use this action when you need to fetch details about a specific notebook belonging to a user, including its display name, sharing status, section URLs, and the user's role on the notebook. Supports OData $select and $expand query parameters to customize the response.

Poll the status of a user's asynchronous OneNote operation.

Retrieves a specific OneNote page from a user's OneNote notebooks. Use this action when you need to fetch metadata or details for a single OneNote page directly by page ID and user ID. This is useful for retrieving page information without navigating through the full notebook/section hierarchy. The default response expands the parentSection relationship and selects its id, name, and self properties.

Retrieves the parent section group of a OneNote section within a user's notebook. Use this action when you need to navigate up the OneNote hierarchy from a section to its parent section group, for example to determine which section group contains a specific section.

List OneNote notebooks owned by a Microsoft 365 group or Teams team. Use this with a group or team ID, including IDs returned by List joined teams.

Retrieves a list of section groups from the specified notebook within a Microsoft 365 group. Use this action to retrieve a page of section groups in a group-owned OneNote notebook to understand its structure or find a specific section group.

Compatibility alias for listing a page of OneNote pages from a specific section within a notebook in a Microsoft 365 group. Prefer the canonical ListOnenoteGroupSectionsPages4 action for new calls. Use this action when you need to retrieve a page of pages from a known section in a group notebook. This action accesses pages directly through the section path without going through section groups.

List section groups at the root of a Microsoft 365 group's OneNote hierarchy.

List sections at the root of a Microsoft 365 group's OneNote hierarchy.

Lists a paginated collection of OneNote sections from a section group within a Microsoft 365 group's OneNote. Use this action when you need to retrieve the sections contained within a section group in a group-owned OneNote notebook. Supports pagination and filtering via OData query parameters. This is a read-only operation that retrieves existing sections without modifying any data.

List Microsoft Teams that a user is a direct member of. Use this to get team IDs, which are also Microsoft 365 group IDs, before listing group-owned OneNote notebooks.

Retrieves a list of OneNote pages from a specific section for the current user.