Skip to main content
NICE CXone Expert
Expert Success Center

pages/{pageid}/find (GET)

Overview

Find pages by constraints. Request must provide a constraint (tags, missingClassification and/or last modified date range).

This API endpoint replaces pages/find?parentid={pageid}. Requests to the old endpoint will respond with an HTTP 302 response and a Location HTTP header to pages/{pageid}/find.

  • REST Method: GET
  • Method Access: public

Uri Parameters

Name Type Description
pageid string either an integer page ID, "home", or "=" followed by a double uri-encoded page path

Query Parameters

Name Type Description
tags string? Comma separated list of tags that pages must contain
missingclassifications string? Comma separated list of classification prefixes that must not exist on the pages
since string? Find pages last modified since this date (format: yyyyMMddHHmmss or yyyy-MM-ddTHH:mm:ssZ)
upto string? Find pages last modified up to this date (format: yyyyMMddHHmmss or yyyy-MM-ddTHH:mm:ssZ), default: now (if since parameter is provided)
include string? Include additional page information. Valid values: "tags", default: tags

Return Codes

Name Value Description
OK 200 The request completed successfully
Bad Request 400 Invalid input parameter or request body

Response Format

<pages count="{int}" totalcount="{int}">
    <page id="{int}" guid="{guid}" draft.state="{active|inactive|unpublished}" href="{uri}" deleted="{bool}">
        <uri.ui>{uri}</uri.ui>
        <title>{text}</title>
        <path seo="{bool}">{text}</path>
        <namespace>{text}</namespace>
        <date.created>{date}</date.created>
        <date.modified>{date}</date.modified>
        <language>en-US</language>
    </page>
    ...
</pages>

Conditions

Response is limited to the first 1000 results.

  • Was this article helpful?