# Microsoft OneNote

Digital notebook for capturing and organizing notes, drawings, and information

- **Category:** productivity
- **Auth:** OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 62
- **Triggers:** 0
- **Slug:** `ONENOTE`
- **Version:** 20260507_00

## Tools

### Copy notebook in group

**Slug:** `ONENOTE_COPY_ONENOTE_GROUP_NOTEBOOK`

Copies a OneNote notebook to the Notebooks folder in the destination Documents library. The notebook is copied asynchronously. This action initiates the copy operation and returns a 202 Accepted response with an Operation-Location header. Use the OnenoteOperationGet action to poll the Operation-Location endpoint to check the status of the copy operation until it completes. Use this action when you need to duplicate a notebook within a Microsoft 365 group, or copy it to a different group's documents library. The copied notebook's folder is created in the destination Documents library if it doesn't exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `groupId` | string | No | The ID of the destination Microsoft 365 group to copy the notebook to. Use only when copying to a different Microsoft 365 group. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group containing the notebook. |
| `renameAs` | string | No | The name to assign to the copied notebook. If not specified, the copy retains the name of the original notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy notebook in site

**Slug:** `ONENOTE_COPY_ONENOTE_SITE_NOTEBOOK`

Copies a OneNote notebook to the destination site in the SharePoint documents library. Use this action when you need to duplicate a notebook within a SharePoint site, or copy it to a different site's documents library. The copied notebook's folder is created in the destination documents library if it doesn't exist. This is an asynchronous operation — the API returns a 202 Accepted response with an Operation-Location header. Poll the provided URL to check whether the copy has completed. The copied notebook becomes available at the destination site once the operation succeeds.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `folder` | string | No | The name of the destination folder in the destination site where the notebook will be copied. If not specified, the notebook is copied to the root folder. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site containing the notebook. |
| `renameAs` | string | No | The name to assign to the copied notebook. If not specified, the copy retains the name of the original notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook to copy. |
| `destinationId` | string | No | The ID of the site to copy the notebook to. Use only when copying to a different SharePoint site. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy section to notebook (site context)

**Slug:** `ONENOTE_COPY_SECTION_TO_NOTEBOOK2`

Copies a OneNote section to a specific notebook within a SharePoint site. Use this action when you need to duplicate an existing OneNote section into a different notebook within the same SharePoint site. The operation is asynchronous and returns an Operation-Location header that should be polled to get the final result. This action is irreversible once the copy operation is initiated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the destination notebook to copy the section into. Required. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site that contains the notebook. |
| `group_id` | string | No | The ID of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group. |
| `rename_as` | string | No | The name to assign to the copied section. If not specified, defaults to the name of the original section. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to copy. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook containing the section to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy section to notebook (user)

**Slug:** `ONENOTE_COPY_SECTION_TO_NOTEBOOK_FOR_USER2`

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. This action is irreversible once the copy operation is initiated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the destination notebook to copy the section into. Required. |
| `user_id` | string | Yes | The unique identifier (ID or userPrincipalName) of the user who owns the section. |
| `group_id` | string | No | The ID of the Microsoft 365 group to copy the section to. Use only when copying to a Microsoft 365 group. |
| `rename_as` | string | No | The name to assign to the copied section. If not specified, defaults to the name of the original section. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to copy. |
| `notebook_id` | string | Yes | The unique identifier of the source notebook that contains the section to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy group section to section group

**Slug:** `ONENOTE_COPY_SECTION_TO_SECTION_GROUP`

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. This action is irreversible once the copy operation is initiated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the destination section group where the section will be copied. Required. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group whose notebook owns the source section. |
| `rename_as` | string | No | The name to assign to the copied section. If not specified, defaults to the name of the original section. |
| `section_id` | string | Yes | The unique identifier of the source section to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy section to section group (user)

**Slug:** `ONENOTE_COPY_SECTION_TO_SECTION_GROUP_FOR_USER`

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. This action is irreversible once the copy operation is initiated.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the destination section group where the section will be copied. Required. |
| `user_id` | string | Yes | The unique identifier (ID or userPrincipalName) of the user who owns the section. |
| `group_id` | string | No | The ID of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group. |
| `rename_as` | string | No | The name to assign to the copied section. If not specified, defaults to the name of the original section. |
| `section_id` | string | Yes | The unique identifier of the source section to copy. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy site page to section

**Slug:** `ONENOTE_COPY_SITE_PAGE_TO_SECTION3`

Copies a OneNote page from a SharePoint site to a destination section. Use this action when you need to duplicate a OneNote page into a different section within the same or a different SharePoint site's notebook. The operation is asynchronous and returns a 202 Accepted response with an Operation-Location header. Poll that endpoint to determine when the copy completes and get the result of the operation. This is an asynchronous operation — the API returns a 202 Accepted response with an Operation-Location header. Poll the provided URL to check whether the copy has completed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Required. The unique identifier of the destination section to copy the page to. |
| `siteId` | string | No | The unique identifier of the destination SharePoint web. Use only when copying to a SharePoint site. |
| `groupId` | string | No | The id of the Microsoft 365 group to copy to. Use only when copying to a Microsoft 365 group. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to copy. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site that contains the notebook. |
| `siteCollectionId` | string | No | The unique identifier of the SharePoint site collection. Use only when copying to a SharePoint site. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy user page to section

**Slug:** `ONENOTE_COPY_USER_PAGE_TO_SECTION`

Copy a OneNote page from a user's notebook to a specified section. Use this action when you need to duplicate a OneNote page into a different section within a user's Microsoft 365 account. This is an asynchronous operation that returns a 202 Accepted response with an Operation-Location header. Poll that endpoint to determine when the copy completes and get the result of the operation. The page is identified by its full path through the notebook's hierarchy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Required. The unique identifier of the destination section to copy the page to. |
| `groupId` | string | No | The unique identifier of the destination Microsoft 365 group. Use only when copying to a group. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to copy. |
| `user_id` | string | Yes | The unique identifier or user principal name of the user who owns the page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count notebook section group sections

**Slug:** `ONENOTE_COUNT_NOTEBOOKS_SECTION_GROUPS_SECTIONS`

Gets the count of OneNote sections within a section group in a user's notebook. 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Count site notebook section group sections

**Slug:** `ONENOTE_COUNT_SITE_NOTEBOOK_SECTION_GROUPS_SECTIONS`

Gets the count of sections within a OneNote section group in a SharePoint site notebook. 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | The unique identifier of the SharePoint site. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the site. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create group notebook

**Slug:** `ONENOTE_CREATE_GROUP_NOTEBOOK`

Creates a new OneNote notebook within a Microsoft 365 group. Use this action when you need to create a new notebook for storing notes within a specific Microsoft 365 group. The notebook will be owned by the specified group and accessible to all members of that group with appropriate permissions. Required permissions: Notes.Create (least privileged), Notes.ReadWrite, or Notes.ReadWrite.All for the group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group that will own the notebook. |
| `display_name` | string | Yes | The name of the new notebook. This is the only required field when creating a notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create group OneNote page

**Slug:** `ONENOTE_CREATE_GROUP_PAGES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `html_content` | string | Yes | The HTML content for the OneNote page. Must be valid HTML including html, head, and body tags. |
| `section_name` | string | No | Optional section name to create the page in a specific section of the default notebook. If the section doesn't exist, a new section will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section in section group

**Slug:** `ONENOTE_CREATE_GROUP_SECTION_GROUPS_SECTIONS`

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: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `display_name` | string | Yes | The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>\|&#''%~ |
| `section_group_id` | string | Yes | The unique identifier of the section group within the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create user notebook

**Slug:** `ONENOTE_CREATE_ME_NOTEBOOKS`

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 and cannot exceed 128 characters or contain special characters (?*\/:<>|&'""). Returns the full created notebook object including the server-assigned ID and URLs for accessing sections.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `display_name` | string | Yes | The name of the new notebook. Must be 128 characters or fewer and cannot contain the characters: ?*\/:<>\|&'" |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section in user's section group

**Slug:** `ONENOTE_CREATE_ME_SECTION_GROUPS_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: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `display_name` | string | Yes | The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>\|&#''%~ |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create OneNote page in section

**Slug:** `ONENOTE_CREATE_ME_SECTIONS_PAGES`

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. This action is idempotent - creating multiple pages with the same title creates separate pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_title` | string | Yes | The title for the OneNote page. |
| `section_id` | string | Yes | The unique identifier of the OneNote section where the page will be created. |
| `html_content` | string | Yes | The HTML body content for the OneNote page (an HTML fragment, not a full document). The action wraps this fragment in <html><head><title>{page_title}</title></head><body>...</body></html>, so do not include outer html/head/body tags. Reference images via external URLs. |
| `page_created_datetime` | string | No | The date and time when the page was created in ISO 8601 format (UTC). Example: 2015-07-22T09:00:00-08:00. If not provided, current time is used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section group in group notebook

**Slug:** `ONENOTE_CREATE_ONENOTE_GROUP_NOTEBOOKS_SECTION_GROUPS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group that owns the notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook in the group. |
| `display_name` | string | Yes | The name of the new section group. Must be 50 characters or fewer. Cannot contain the characters: ? * / : < > \| & # ' % ~ |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section in site notebook

**Slug:** `ONENOTE_CREATE_SITE_NOTEBOOKS_SECTIONS`

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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | No | The unique identifier of the SharePoint site that contains the notebook. Optional - if not provided, uses the user's personal OneNote. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the site. |
| `display_name` | string | Yes | The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>\|&#''%~ |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section in user notebook

**Slug:** `ONENOTE_CREATE_USER_NOTEBOOKS_SECTIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the user. Use 'me' for the current signed-in user. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook. |
| `display_name` | string | Yes | The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>\|&#''%~ |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create user OneNote page

**Slug:** `ONENOTE_CREATE_USER_PAGES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier or user principal name (UPN) of the user who owns the OneNote notebook. |
| `html_content` | string | Yes | The HTML content for the OneNote page. Must be valid HTML including html, head, and body tags. |
| `section_name` | string | No | Optional section name to create the page in a specific section of the default notebook. If the section doesn't exist, a new section will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create section in user section group

**Slug:** `ONENOTE_CREATE_USER_SECTION_GROUPS_SECTIONS`

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: ?*/:<>|&#''%~. This action is idempotent — calling it multiple times with the same display name may create duplicate sections depending on the API's handling of unique-name constraints.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `display_name` | string | Yes | The name of the new section. Must be 50 characters or fewer and cannot contain the characters: ?*/:<>\|&#''%~ |
| `section_group_id` | string | Yes | The unique identifier of the section group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create user section page

**Slug:** `ONENOTE_CREATE_USER_SECTIONS_PAGES4`

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). This action requires the Content-Type header to be set to text/html for the request body. This action is idempotent — calling it multiple times creates separate pages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `page_title` | string | No | The title for the OneNote page. Required when page_created_datetime is provided, because OneNote requires a title in the HTML head section generated by this action. |
| `section_id` | string | Yes | The unique identifier of the OneNote section where the page will be created. |
| `html_content` | string | Yes | The HTML for the OneNote page. If neither page_title nor page_created_datetime is provided, send a complete HTML document (with html/head/body tags). If either is provided, send only the body fragment — the action wraps it in <html><head><title>{page_title}</title>...</head><body>...</body></html> for you, so do not include outer html/head/body tags in that case. |
| `page_created_datetime` | string | No | The date and time when the page was created in ISO 8601 format (UTC). Example: 2015-07-22T09:00:00-08:00. If not provided, current time is used. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete page content from section group section

**Slug:** `ONENOTE_DELETE_ONENOTE_GROUP_SECTION_GROUP_PAGE_CONTENT`

Deletes the HTML content of a OneNote page within a section in a section group in a Microsoft 365 group's OneNote workspace. This action is irreversible — the page content will be permanently deleted once removed. Use this action when you need to clear the content of a specific OneNote page within a section group hierarchy in a Microsoft 365 group.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page whose content will be deleted. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_id` | string | Yes | The unique identifier of the section within the section group. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the group's OneNote workspace. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete OneNote page from section

**Slug:** `ONENOTE_DELETE_ONENOTE_GROUP_SECTIONS_PAGES2`

Delete a specific OneNote page from a section within a notebook in a group. Use this action when you need to remove a OneNote page permanently from a group's notebook section. This action is irreversible - once deleted, the page cannot be recovered.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to delete. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_id` | string | Yes | The unique identifier of the section within the notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete OneNote page from site

**Slug:** `ONENOTE_DELETE_SITE_PAGES`

Deletes a OneNote page from a SharePoint site. Use this action when you need to remove a OneNote page permanently from a SharePoint site's OneNote workspace. This action is irreversible - once deleted, the page and all its content cannot be recovered.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to delete. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Can be the site hostname or server-relative path. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete user OneNote page from section

**Slug:** `ONENOTE_DELETE_USER_ONENOTE_SECTIONS_PAGES`

Deletes a OneNote page from a section within a section group in a user's notebook. This action is irreversible — the page and all its content will be permanently deleted once removed. Use this action when you need to remove an unwanted page from a section in a user's OneNote notebook.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to delete. |
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `section_id` | string | Yes | The unique identifier of the section within the section group. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook containing the section group. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete OneNote page for user

**Slug:** `ONENOTE_DELETE_USER_PAGES`

Deletes a OneNote page from a user's OneNote workspace. This action is irreversible — the page and all its content will be permanently deleted once removed. 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to delete. |
| `user_id` | string | Yes | The unique identifier of the Microsoft 365 user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get a OneNote section from a group

**Slug:** `ONENOTE_GET_GROUP_SECTIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand inline in the response. Valid values: parentNotebook, parentSectionGroup. |
| `select` | array | No | Comma-separated list of section properties to include in the response. Valid values include: id, self, createdDateTime, displayName, createdBy, lastModifiedBy, lastModifiedDateTime, isDefault, links, pagesUrl, parentNotebook, parentSectionGroup. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote resource content by ID

**Slug:** `ONENOTE_GET_ME_ONENOTE_RESOURCES_VALUE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `resource_id` | string | Yes | The unique identifier of the OneNote resource (e.g., image, file attachment, or other embedded content). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote page content from section

**Slug:** `ONENOTE_GET_ME_SECTION_PAGE_CONTENT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page. This can be the full resource path including the section ID. |
| `include_ids` | boolean | No | Optional. When set to true, the returned HTML includes IDs for page elements. Useful when you need to identify elements for updates or modifications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get notebook from web URL

**Slug:** `ONENOTE_GET_NOTEBOOK_FROM_WEB_URL`

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).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier (ID) or user principal name (UPN) of the user whose notebook to retrieve. |
| `web_url` | string | Yes | The URL path of the notebook to retrieve. Can also contain an 'onenote:' prefix. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get notebook section group

**Slug:** `ONENOTE_GET_NOTEBOOK_SECTION_GROUP`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | string | No | Comma-separated list of relationships to expand (e.g., 'parentNotebook,parentSectionGroup'). |
| `select` | string | No | Comma-separated list of properties to include in the response. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the group's OneNote. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get group OneNote operation status

**Slug:** `ONENOTE_GET_ONENOTE_GROUP_OPERATIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group that owns the OneNote notebook. |
| `operation_id` | string | Yes | The unique identifier of the long-running OneNote operation to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get a OneNote page from a section group section

**Slug:** `ONENOTE_GET_ONENOTE_GROUP_SECTIONS_PAGES`

Retrieves a specific OneNote page from a section within a section group in a Microsoft 365 group's notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent group, notebook, section group, and section hierarchy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook. |
| `select` | array | No | Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to retrieve. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_id` | string | Yes | The unique identifier of the section within the section group. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the group. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get site OneNote operation status

**Slug:** `ONENOTE_GET_ONENOTE_SITE_OPERATIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | The unique identifier of the SharePoint site that owns the OneNote notebook. This can be the server-relative path (e.g., contoso.sharepoint.com,3e3b477e-21ed-448b-a7fe-573b718dc5ff,3d7e3c8f-7133-4b2d-ba53-418d9ef48bab). |
| `operation_id` | string | Yes | The unique identifier of the long-running OneNote operation to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote page content for user

**Slug:** `ONENOTE_GET_ONENOTE_USER_PAGE_CONTENT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to get content from. |
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current user, or specify a user ID (GUID) or user principal name (email). |
| `include_ids` | boolean | No | When true, the returned HTML includes IDs that can be used to update the page. Use this when preparing content for page updates. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote page from site

**Slug:** `ONENOTE_GET_SITE_ONENOTE_PAGES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | List of relationships to expand inline in the response. Valid values: 'parentSection', 'parentNotebook'. |
| `select` | array | No | List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'content', 'contentUrl', 'createdByAppId', 'level', 'order', 'links', 'parentSection', 'parentNotebook'. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to retrieve. This is the full page ID including any section path prefix (e.g., '1-abc123!71-7aef1f00-3deb-4ee2-93ab-979eb24a3037'). |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Use 'root' for the root site. For SharePoint sites, this is typically in the format: hostname,site-collection-id,site-id (e.g., 'contoso.sharepoint.com,12345678-1234-1234-1234-123456789012,87654321-4321-4321-4321-210987654321'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get site notebook page preview

**Slug:** `ONENOTE_GET_SITE_PAGES_PREVIEW`

Retrieves a text preview of a specific OneNote page from a section within a section group in a SharePoint site-hosted notebook. Use this action when you need to quickly get the content preview of a OneNote page from a site-hosted notebook without fetching the full page content. The preview returns a text snippet of the page's content. This action is read-only and does not modify any data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page. |
| `site_id` | string | No | The unique identifier of the SharePoint site. Optional - if not provided, uses the signed-in user's personal OneNote notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get a OneNote section from a site

**Slug:** `ONENOTE_GET_SITE_SECTIONS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand inline in the response. Valid values: parentNotebook, parentSectionGroup. |
| `select` | array | No | Comma-separated list of section properties to include in the response. Valid values include: id, self, createdDateTime, displayName, createdBy, lastModifiedBy, lastModifiedDateTime, isDefault, links, pagesUrl, parentNotebook, parentSectionGroup. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Use 'root' for the root site. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote page from site section group section

**Slug:** `ONENOTE_GET_SITE_SECTIONS_PAGES`

Retrieves a specific OneNote page from a section within a section group in a SharePoint site notebook. Use this action when you need to fetch metadata or details for a single OneNote page by navigating through its parent site, notebook, section group, and section hierarchy. This is useful for retrieving page information from deeply nested notebook structures within SharePoint sites.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook. |
| `select` | array | No | Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to retrieve. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Use 'root' for the root site. |
| `section_id` | string | Yes | The unique identifier of the section within the section group. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the site. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get user notebook

**Slug:** `ONENOTE_GET_USER_NOTEBOOK`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand (OData $expand). Valid values: sections, sectionGroups. |
| `select` | array | No | Comma-separated list of notebook properties to include in the response (OData $select). |
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get a OneNote page from user

**Slug:** `ONENOTE_GET_USER_PAGES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand inline in the response. Valid values: parentSection, parentNotebook. |
| `select` | array | No | Comma-separated list of page properties to include in the response. Valid values include: id, self, title, createdDateTime, lastModifiedDateTime, content, contentUrl, createdByAppId, level, order, links, parentSection, parentNotebook. |
| `page_id` | string | Yes | The unique identifier of the OneNote page to retrieve. |
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get parent section group from user section

**Slug:** `ONENOTE_GET_USER_PARENT_SECTION_GROUP2`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | Comma-separated list of relationships to expand. Valid values: parentNotebook. |
| `select` | array | No | Comma-separated list of properties to select. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self, createdBy, lastModifiedBy. |
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user. Use 'me' for the current authenticated user. |
| `section_id` | string | Yes | The unique identifier of the OneNote section within the notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List notebook section groups

**Slug:** `ONENOTE_LIST_GROUP_NOTEBOOK_SECTION_GROUPS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of items to return in the collection. Default is 25, maximum is 100. |
| `expand` | array | No | Comma-separated list of navigation properties to expand (e.g., sections, sectionGroups, parentNotebook, parentSectionGroup). |
| `filter` | string | No | OData filter expression to filter the results. |
| `select` | array | No | Comma-separated list of section group properties to include in the response. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Default order is name ascending. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List pages from a group notebook section

**Slug:** `ONENOTE_LIST_GROUP_NOTEBOOK_SECTION_PAGES`

Lists all OneNote pages from a specific section within a notebook in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook. This action accesses pages directly through the section path without going through section groups.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | Comma-separated list of page properties to include in the response. Valid properties include: id, self, title, createdDateTime, lastModifiedDateTime, contentUrl, createdByAppId, level, order, links. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Default order is lastModifiedDateTime descending. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `page_size` | integer | No | The number of pages to return per request. Default is 20, maximum is 100. |
| `section_id` | string | Yes | The unique identifier of the section within the notebook. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List section group sections

**Slug:** `ONENOTE_LIST_GROUP_SECTION_GROUPS_SECTIONS`

Lists all OneNote sections from a specific 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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of sections to return per request. Defaults to 25. |
| `expand` | array | No | Comma-separated list of relationships to expand. Valid values: parentNotebook, parentSectionGroup. |
| `filter` | string | No | OData filter expression to apply to filter results. Example: displayName eq 'My Section'. |
| `select` | array | No | Comma-separated list of section properties to include in the response. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl, self, createdBy, lastModifiedBy. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Example: displayName asc. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_group_id` | string | Yes | The unique identifier of the section group within the group's OneNote. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List pages in section

**Slug:** `ONENOTE_LIST_ME_ONENOTE_SECTIONS_PAGES4`

Retrieves a list of OneNote pages from a specific section for the current user. Use this action when you need to retrieve all pages from a specific section in the current user's OneNote notebook. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. The default query returns the top 20 pages ordered by lastModifiedTime descending. Note: This action is read-only and does not modify any data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | List of relationships to expand. Use 'parentSection' or 'parentNotebook' to include parent details. |
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'contentUrl'. |
| `orderby` | array | No | List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'. |
| `page_size` | integer | No | The number of pages to return per request. Defaults to 25. Maximum is 100. |
| `section_id` | string | Yes | The unique identifier of the OneNote section. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List group OneNote pages

**Slug:** `ONENOTE_LIST_ONENOTE_GROUP_PAGES`

Lists all OneNote pages from a Microsoft 365 group. Use this action when you need to retrieve all OneNote pages within a Microsoft 365 group. Supports pagination via the page_size parameter. The default page size is 25, and the maximum is 100. Results are ordered by lastModifiedDateTime descending by default.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime'. |
| `orderby` | array | No | List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `page_size` | integer | No | The number of pages to return per request. Defaults to 25. Maximum is 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List group section group section groups

**Slug:** `ONENOTE_LIST_ONENOTE_GROUP_SECTION_GROUPS_SECTION_GROUPS2`

Lists all section groups from a specified parent section group within a Microsoft 365 group's OneNote notebook. Use this action when you need to retrieve the nested section groups within a section group in a group context to navigate the OneNote notebook hierarchy. This action supports OData query parameters for filtering, sorting, pagination, and expanding related entities.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of items to return in the collection. Default is 25. |
| `expand` | array | No | Comma-separated list of relationships to expand. Valid values: sections, sectionGroups, parentNotebook, parentSectionGroup. |
| `filter` | string | No | OData filter expression to apply. Example: displayName eq 'My Section Group'. |
| `select` | array | No | Comma-separated list of properties to select. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Example: displayName asc. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `section_group_id` | string | Yes | The unique identifier of the parent section group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List pages from a group section

**Slug:** `ONENOTE_LIST_ONENOTE_GROUP_SECTIONS_PAGES4`

Lists all OneNote pages from a specific section in a Microsoft 365 group. Use this action when you need to retrieve all pages from a known section in a group notebook without specifying the notebook ID. This action supports pagination, filtering, sorting, and relationship expansion via OData query parameters. Note: This action is read-only and does not modify any data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `expand` | array | No | List of relationships to expand. Use 'parentSection' or 'parentNotebook' to include parent details. |
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | List of page properties to include in the response. Common values: 'id', 'title', 'createdDateTime', 'lastModifiedDateTime', 'contentUrl', 'createdByAppId', 'level', 'order', 'links'. |
| `orderby` | array | No | List of properties to order results by. Common values: 'createdDateTime', 'lastModifiedDateTime', 'title'. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group. |
| `page_size` | integer | No | The number of pages to return per request. Defaults to 25. Maximum is 100. |
| `section_id` | string | Yes | The unique identifier of the OneNote section. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List site notebook section groups

**Slug:** `ONENOTE_LIST_SITE_NOTEBOOK_SECTION_GROUPS`

Retrieves a list of section groups from the specified notebook within a SharePoint site. Use this action when you need to list all section groups in a SharePoint site-owned OneNote notebook to understand its structure or to find a specific section group. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of items to return in the collection. Default is 25, maximum is 100. |
| `expand` | array | No | Comma-separated list of navigation properties to expand. Valid values: sections, sectionGroups, parentNotebook, parentSectionGroup. |
| `filter` | string | No | OData filter expression to filter the results. Example: displayName eq 'My Section Group'. |
| `select` | array | No | Comma-separated list of section group properties to include in the response. Valid values: id, displayName, createdDateTime, lastModifiedDateTime, sectionsUrl, sectionGroupsUrl, self, createdBy, lastModifiedBy. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Default order is name ascending. Example: displayName asc. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get OneNote page content from SharePoint site

**Slug:** `ONENOTE_LIST_SITE_PAGES_CONTENT`

Retrieves the HTML content of a specific OneNote page within a SharePoint site. Use this action when you need to fetch the full HTML content of a OneNote page from a SharePoint site for processing, rendering, or exporting page data. This endpoint provides direct access to page content without requiring notebook or section context. Returns the raw HTML content of the page, including text, images, and other embedded content references. Note: This action is read-only and does not modify any data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page. Format is typically 'pageId!sectionId' (e.g., '1-c82b4070fd284fd89902a39ce5937394!71-7aef1f00-3deb-4ee2-93ab-979eb24a3037'). |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Can be the site hostname and relative path (e.g., 'contoso.sharepoint.com,123abc,456def') or a server-relative path. |
| `include_ids` | boolean | No | Optional. When set to true, the returned HTML includes IDs for page elements. Useful when you need to identify elements for updates or modifications. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List site sections

**Slug:** `ONENOTE_LIST_SITE_SECTIONS`

Retrieves a list of OneNote sections from a SharePoint site. Use this action when you need to list all OneNote sections within a SharePoint site's OneNote notebook to understand its structure or to find a specific section. This is a read-only operation that retrieves existing sections without modifying any data. Supports OData query parameters for filtering, sorting, pagination, and property expansion. The default sort order is name ascending. The default query expands parentNotebook and selects its id, displayName, and self properties.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of sections to return per request. Default is 25, maximum is 100. |
| `expand` | array | No | Comma-separated list of navigation properties to expand. Valid values: parentNotebook, parentSectionGroup. |
| `filter` | string | No | OData filter expression to apply to filter results. Example: displayName eq 'My Section'. |
| `select` | array | No | Comma-separated list of section properties to include in the response. Common values: id, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl. |
| `orderby` | array | No | Comma-separated list of properties to order results by. The default sort order is name ascending. Example: displayName asc. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Can be 'root' for the root site, or a site path in the format 'hostname,site-id,web-id'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List user notebooks

**Slug:** `ONENOTE_LIST_USER_NOTEBOOKS`

Lists all OneNote notebooks accessible by a specific user. Use this action when you need to retrieve the available notebooks for a user, display notebook listings, or browse notebooks that are owned by or shared with a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or a user principal name (UPN). Use 'me' to reference the signed-in user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | Comma-separated list of notebook properties to include in the response (OData $select). |
| `orderby` | array | No | Comma-separated list of properties to order results by (OData $orderby). Default order is 'displayName asc'. |
| `user_id` | string | Yes | The unique identifier (GUID) or user principal name (UPN) of the user whose notebooks to retrieve. Use 'me' to reference the signed-in user. |
| `page_size` | integer | No | The number of notebooks to return per request. Default is 25. Maximum is 100. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List user notebook sections

**Slug:** `ONENOTE_LIST_USER_NOTEBOOK_SECTIONS`

Lists all OneNote sections from a specified notebook belonging to a user. Use this action when you need to retrieve all sections within a notebook that is owned by or accessible to a specific user. Supports OData query parameters for filtering, sorting, and pagination. Note: The user_id can be a GUID or user principal name (UPN). Use 'me' to reference the signed-in user. The default sort order is by display name ascending. This is a read-only operation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `top` | integer | No | The number of sections to return per request. Defaults to 25. Maximum is 100. |
| `expand` | array | No | Comma-separated list of relationships to expand. Valid values: parentNotebook, parentSectionGroup. |
| `filter` | string | No | OData filter expression to apply to filter results. |
| `select` | array | No | Comma-separated list of section properties to include in the response. Valid values include: id, self, displayName, createdDateTime, lastModifiedDateTime, isDefault, pagesUrl, links, createdBy, lastModifiedBy. |
| `orderby` | array | No | Comma-separated list of properties to order results by. Default order is 'displayName asc'. |
| `user_id` | string | Yes | The unique identifier (GUID) or user principal name (UPN) of the user. Use 'me' to reference the signed-in user. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update my OneNote page content

**Slug:** `ONENOTE_UPDATE_ME_PAGE_CONTENT`

Update the content of a OneNote page for the signed-in user. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, prepending content, and deleting elements. Use this action when you need to update or modify the content of an existing OneNote page owned by the signed-in user, such as adding new paragraphs, inserting images, modifying lists, or replacing/removing existing elements. This action is idempotent for replace, append, prepend, and insert operations, but delete operations are irreversible — deleted elements cannot be recovered once removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to update. |
| `commands` | array | Yes | Array of patch commands to apply to the page. Each command specifies a target element, action, and optional content and position. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update my OneNote section

**Slug:** `ONENOTE_UPDATE_ME_SECTIONS`

Updates the navigation property sections in me. Use when you need to modify properties of an existing OneNote section, such as renaming it, within the current user's notebooks. This action uses a PATCH request to update the section entity at the specified path. Use this action when you need to update a specific OneNote section owned by the authenticated user, such as changing its display name. This is an idempotent operation that modifies the specified properties while preserving all other existing values. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `section_id` | string | Yes | The unique identifier of the OneNote section to update. |
| `display_name` | string | No | The new name for the section. Must be 50 characters or fewer and cannot contain: ?*/:<>\|&#''%~. If not provided, the current name is preserved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update OneNote page content

**Slug:** `ONENOTE_UPDATE_ONENOTE_PAGE_CONTENT`

Update the content of a OneNote page within a Microsoft 365 group using HTML patch commands. Use this action when you need to modify the content of an existing OneNote page, such as replacing text, inserting new content, or appending elements. The action supports multiple patch commands in a single request. The API returns 204 No Content on success, meaning no JSON response body is returned.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to update. |
| `commands` | array | Yes | Array of patch commands to apply to the page. Each command specifies a target element, action, and content. |
| `group_id` | string | Yes | The unique identifier of the Microsoft 365 group that owns the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update section in site notebook

**Slug:** `ONENOTE_UPDATE_SITE_NOTEBOOKS_SECTIONS`

Updates a OneNote section within a notebook in a SharePoint site. Use this action when you need to modify properties of an existing section, such as renaming it. This action uses a PATCH request to update the section entity at the specified path within the site's notebook hierarchy. Note: Only the displayName property of a section can be updated via this endpoint. Other properties like createdDateTime, isDefault, etc. are read-only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | The unique identifier of the Microsoft Graph user who owns the section. Use 'me' for the signed-in user. |
| `section_id` | string | Yes | The unique identifier of the section to update within the notebook. |
| `notebook_id` | string | No | The unique identifier of the OneNote notebook containing the section. Optional - kept for backwards compatibility. |
| `display_name` | string | No | The new name to assign to the section. Must be 50 characters or fewer and cannot contain: ? * / : < > \| & # ' % ~. If not provided, the current name is preserved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update site OneNote page content

**Slug:** `ONENOTE_UPDATE_SITE_PAGES_CONTENT`

Update the content of a OneNote page within a SharePoint site. Sends a PATCH request with patch content commands to modify the HTML structure of a OneNote page. Supports appending children, inserting siblings, replacing elements, prepending content, and deleting elements. Use this action when you need to update or modify the content of an existing OneNote page within a SharePoint site, such as adding new paragraphs, inserting images, modifying lists, or replacing/removing existing elements. This action is idempotent for replace, append, prepend, and insert operations, but delete operations are irreversible — deleted elements cannot be recovered once removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_id` | string | Yes | The unique identifier of the OneNote page to update. |
| `site_id` | string | Yes | The unique identifier of the SharePoint site that owns the notebook. |
| `commands` | array | Yes | Array of patch commands to apply to the page. Each command specifies a target element, action, and optional content and position. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update site section group section

**Slug:** `ONENOTE_UPDATE_SITE_SECTION_GROUPS_SECTIONS`

Updates a OneNote section within a section group in a SharePoint site notebook. Use this action when you need to modify properties of an existing OneNote section, such as updating its display name. This action uses a PATCH request to update the section entity at the specified path within the SharePoint site's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties are read-only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `site_id` | string | Yes | The unique identifier of the SharePoint site. Can be the server-relative path (e.g., 'sites/contoso') or a SharePoint site ID in the format 'hostname,tenant-id,site-id'. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to update. |
| `notebook_id` | string | Yes | The unique identifier of the OneNote notebook within the SharePoint site. |
| `display_name` | string | No | The new name for the section. Must be 50 characters or fewer and cannot contain: ?*/:<>\|&#''%~ |
| `section_group_id` | string | Yes | The unique identifier of the section group within the notebook. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update section in user notebook

**Slug:** `ONENOTE_UPDATE_USER_NOTEBOOKS_SECTIONS`

Updates a OneNote section within a user's notebook. Use this action when you need to modify properties of an existing OneNote section, such as renaming it, for a specific user identified by their Microsoft Graph user ID. This action uses a PATCH request to update the section entity at the specified path within the user's notebook hierarchy. Note: Only the displayName property can be updated via this endpoint. Other properties like isDefault, createdDateTime, etc. are read-only.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user_id` | string | Yes | The unique identifier of the Microsoft Graph user who owns the notebook. |
| `section_id` | string | Yes | The unique identifier of the OneNote section to update. |
| `display_name` | string | No | The new name for the section. Must be 50 characters or fewer and cannot contain: ? * / : < > \| & # ' % ~. If not provided, the current name is preserved. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |