Skip to main content
NICE CXone Expert

We will be updating our infrastructure on Dec 2, 2023. Sites will be down starting at 8pm Pacific time. This may last up to 3 hours.

Expert Success Center

archive/pages/{pageid}/subpages (GET)

Overview

Retrieve the child pages that were deleted as well from deleting the given page

  • REST Method: GET
  • Method Access: public

Uri Parameters

Name Type Description
pageid string An integer page ID of a deleted page

Query Parameters

Name Type Description
authenticate bool? Force authentication for request (default: false)

Return Codes

Name Value Description
OK 200 The request completed successfully
Forbidden 403 Administrator access is required

Message Format

Output:

<pages.archive>
  <page.archive id="{id}" href="{uri}">
    <title>{text}</title> 
    <path>{text}</path> 
    <contents type="{contenttype}" href="{uri}" /> 
  </page.archive>
  ...
</pages.archive>

Implementation Notes

When a page is deleted, the page and all files on it are moved into the archive. A page is never permanently deleted; it will remain in the archive until it is restored (POST:archive/pages/{pageid}/restore). While a page is in the archive, it cannot be modified.

Use GET:archive/pages to retrieve a list of pages currently in the archive.

C# Code Sample: Retrieve Archived Page's Subpages

The following code example retrieves the subpages for the archived page ID 10168:

Sample Code

Plug p = Plug.New("http://deki-hayes/@api/deki");
p.At("users", "authenticate").WithCredentials("admin", "password").Get();
p.At("archive", "pages", "10168", "subpages").Get();

Sample Response from executing Code

<pages.archive>
  <page.archive id="10169" href="http://deki-hayes/@api/deki/archive/pages/10169/info">
    <title>MySubPage</title> 
    <path>MyPage/MySubPage</path> 
    <contents type="application/x.deki0702+xml" href="http://deki-hayes/@api/deki/archive/pages/10169/contents" /> 
  </page.archive>
</pages.archive>

Implementation notes 

Add notes about requirements or config values

Curl Code Sample: Retrieve Archived Page's Subpages

The following command retrieves information about the subpages of an archived page (page.archiveID = 1)

Sample Code

curl -u admin:password -i http://mindtouch.address/@api/deki/archive/pages/1/subpages

Sample Response

page.archiveID = 589 (page name "Test") has two subpages.

<pages.archive>
  <page.archive id="563" href="http://192.168.59.128/@api/deki/archive/pages/563/info">
    <title>Foo</title>
    <path>Test/Foo</path> <!-- Foo, subpage of Test -->
    <contents type="application/x.deki0805+xml" href="http://192.168.59.128/@api/deki/archive/pages/563/contents"/>
  </page.archive>
  <page.archive id="564" href="http://192.168.59.128/@api/deki/archive/pages/564/info">
    <title>Pidgin</title>
    <path>Test/Foo/Pidgin</path> <!-- Pidgin, subpage of Foo, which is a subpage of Test -->
    <contents type="application/x.deki0805+xml" href="http://192.168.59.128/@api/deki/archive/pages/564/contents"/>
  </page.archive>
</pages.archive>

Implementation notes 

curl flags

-u
Provides external user authentication.
-i
Outputs the HTTP response headers. Useful for debugging.

Permissions

ADMIN permission is required to execute above command.

Archived Pages

To view a list of archived pages, follow the instructions here.

Subpages

If an archived page has no subpages, the response data will contain an empty XML document. i.e:
<pages.archive />
  • Was this article helpful?