onenote resource type

The entry point for OneNote resources.

All calls to the OneNote service through the Microsoft Graph API use this service root URL:

https://graph.microsoft.com/{version}/{location}/onenote/ 

The location can be user notebooks on Office 365 or consumer OneDrive, group notebooks or SharePoint site-hosted team notebooks on Office 365.

User notebooks To access personal notebooks on consumer OneDrive or OneDrive for Business, use one of the following URLs:

https://graph.microsoft.com/{version}/me/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{userPrincipalName}/onenote/{notebooks | sections | sectionGroups | pages} 
https://graph.microsoft.com/{version}/users/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Group notebooks To access notebooks that are owned by a group, use the following service root URL:

https://graph.microsoft.com/{version}/groups/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

SharePoint site notebooks To access notebooks that are owned by a SharePoint team site, use the following service root URL:

https://graph.microsoft.com/{version}/sites/{id}/onenote/{notebooks | sections | sectionGroups | pages} 

Authorization

For information about the permissions required to work with OneNote APIs, see Notes permissions.

Relationships

Relationship Type Description
notebooks Notebook collection The collection of OneNote notebooks that are owned by the user or group. Read-only. Nullable.
operations Operation collection The status of OneNote operations. Getting an operations collection is not supported, but you can get the status of long-running operations if the Operation-Location header is returned in the response. Read-only. Nullable.
pages Page collection The pages in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
resources Resource collection The image and other file resources in OneNote pages. Getting a resources collection is not supported, but you can get the binary content of a specific resource. Read-only. Nullable.
sectionGroups SectionGroup collection The section groups in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
sections Section collection The sections in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.

Methods

Method Return Type Description
Create notebook Notebook Create a notebook by posting to the notebooks collection.
List notebooks Notebook collection Get a collection of notebooks.
Create page Page Create a page by posting to the pages collection.
List pages Page collection Get a collection of pages.
List section groups SectionGroup collection Get a collection of section groups.
List sections Section collection Get a collection of sections.