Add ability to include nested Pages while archiving via REST API

Description

Its possible to archive a list of Pages using Confluence Cloud's REST API via the Archive Pages endpoint.

However, there is no option to specify a Page ID and automatically include nested Pages. This is only possible through Confluence Cloud's interface where a checkbox "include nested pages" is displayed in the Archive dialogue.

Screenshot for reference:

Workaround

As a Workaround, it is possible to use the Get content descendants by type v1 endpoint to get a list of Page IDs for Children and Descendants:

GET /wiki/rest/api/content/{id}/descendant/{type}

As an example, the following link can be accessed:

https://example.atlassian.net/wiki/rest/api/content/123456789/descendant/page

PS: Just make sure to replace example with your site name and 123456789 with the Page ID.