Skip to main content

Method

Queries pages and data sources that are children of a data source. Supports filtering, sorting, and pagination.

Parameters

string
required
The ID of the data source to query (with or without dashes)
PropertyFilter | TimestampFilter | { and: Filter[] } | { or: Filter[] }
Filter conditions to apply to the query. Can be a single filter, or a compound filter using and or or operators.Supports filtering by:
  • Property values (text, number, checkbox, select, date, etc.)
  • Timestamps (created_time, last_edited_time)
Array<PropertySort | TimestampSort>
Sort criteria for the results.Property sort:
Timestamp sort:
string
Pagination cursor returned from a previous query. Used to fetch the next page of results.
number
Number of results to return per page. Maximum is 100 (default).
string[]
Array of property IDs to include in the response. Only these properties will be returned for each page.
boolean
Filter by archived status. If true, only archived pages are returned. If false, only non-archived pages.
boolean
Filter by trash status. If true, only trashed pages are returned. If false, only non-trashed pages.
'page' | 'data_source'
Filter results to only include pages or data sources. Regular databases only support page children. The default behavior returns both pages and data sources for wikis.
string
Bearer token for authentication. Overrides the client-level auth if provided.

Response

Returns a paginated list of pages and/or data sources.
string
Always "list"
string
Always "page_or_data_source"
Array<PageObjectResponse | DataSourceObjectResponse>
Array of page and/or data source objects matching the query
string | null
Cursor for the next page of results. null if there are no more results.
boolean
Whether there are more results available

Examples

Query all pages

Filter by property value

Sort by property

Complex filter with AND/OR

Paginate through results

Manual pagination

Filter by timestamp