onenote resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

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 Microsoft 365 or consumer OneDrive, group notebooks, or SharePoint site-hosted team notebooks on Microsoft 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 onenoteOperation collection 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.
pages onenotePage collection The pages in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
resources onenoteResource collection 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.
sectionGroups sectionGroup collection The section groups in all OneNote notebooks that are owned by the user or group. Read-only. Nullable.
sections onenoteSection 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 onenotePage Create a page by posting to the pages collection.
List pages onenotePage collection Get a collection of pages.
List section groups sectionGroup collection Get a collection of section groups.
List sections onenoteSection collection Get a collection of sections.
{
  "notebooks": [{ "@odata.type": "microsoft.graph.notebook" }],
  "operations": [{ "@odata.type": "microsoft.graph.onenoteOperation" }],
  "pages": [{ "@odata.type": "microsoft.graph.onenotePage" }],
  "resources": [ { "@odata.type": "microsoft.graph.onenoteResource" } ],
  "sectionGroups": [ { "@odata.type": "microsoft.graph.sectionGroup" } ],
  "sections": [ { "@odata.type": "microsoft.graph.onenoteSection" } ]
}