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.