Get knowledge hub root nodes

When true, only nodes that have children are returned (useful for building sidebar / tree navigation). Leaf nodes are excluded. yes/no, on/off and 1/0 are read as booleans too; anything else is answered 422.

Page number (1-indexed, at most 50). Combined with limit to paginate results. Prefer cursor: a page number is reached by reading the pages before it. A search by a connected app whose limit names any spaces, folders or files takes a page number of at most 5; for later pages, send nextCursor.

Opaque cursor from pagination.nextCursor or pagination.prevCursor of a previous response. It decides the listing mode, parent, filters and sort. include and limit come from this request. A next cursor returns the following page, and a previous cursor returns the page before. A cursor whose parent disagrees with the URL, or that was issued for another user, is refused with 400.

Maximum number of items to return per page.

Field to sort results by. Omitted → default updatedAt. Any other value is answered 400 ("Invalid sort_by: ...").

Sort direction. Omitted → default desc. Read case-insensitively; any other value is answered 400 ("Invalid sort_order: ...").

Full-text search query. Must be between 2 and 500 characters (inclusive) after surrounding whitespace is removed, otherwise 400. When provided, the endpoint searches across the entire node tree regardless of the current browse level. A repeated q is joined with commas into one query, and a q sent as an object (q[a]=b) is refused with 400 ("Search query must be text").

Comma-separated list of node types to include. An unknown value is answered 400 ("Invalid node_types value(s): ..."). Maximum 100 items.

Valid values: folder, app, recordGroup, record

Comma-separated list of record types to include. An unknown value is answered 400 ("Invalid record_types value(s): ..."). Maximum 100 items.

Valid values: FILE, DRIVE, WEBPAGE, DATABASE, DATASOURCE, MESSAGE, MAIL, GROUP_MAIL, TICKET, COMMENT, INLINE_COMMENT, CONFLUENCE_PAGE, CONFLUENCE_BLOGPOST, SHAREPOINT_PAGE, SHAREPOINT_LIST, SHAREPOINT_LIST_ITEM, SHAREPOINT_DOCUMENT_LIBRARY, LINK, PROJECT, PULL_REQUEST, MEETING, PRODUCT, DEAL, CASE, TASK, ARTIFACT, CODE_FILE, SQL_TABLE, SQL_VIEW, OTHERS

Comma-separated list of origin types to include. An unknown value is answered 400 ("Invalid origins value(s): ..."). Maximum 100 items.

Valid values: COLLECTION, CONNECTOR

Comma-separated list of connector instance IDs (UUIDs) to filter by. Maximum 100 items. No enum validation — any string is accepted, but non-existent IDs simply yield zero results.

Comma-separated list of indexing statuses to include. An unknown value is answered 400 ("Invalid indexing_status value(s): ..."). Maximum 100 items.

Valid values: NOT_STARTED, PAUSED, IN_PROGRESS, COMPLETED, FAILED, FILE_TYPE_NOT_SUPPORTED, AUTO_INDEX_OFF, EMPTY, ENABLE_MULTIMODAL_MODELS, QUEUED, SKIPPED, PASSWORD_PROTECTED

Created-date range filter. Format: gte:<epochMs>,lte:<epochMs>. Both bounds are optional (you may send just gte:... or just lte:...). Timestamps must be in the range 0 to 9999999999999 and gte must be less than or equal to lte when both are present; a bound that is not a whole number, is out of range, or an inverted range is answered 400. A value with no gte:/lte: part is ignored.

Updated-date range filter. Same format and constraints as createdAt.

File-size range filter in bytes. Format: gte:<bytes>,lte:<bytes>. Both bounds are optional. Values must be non-negative and at most 1099511627776 (1 TB). gte must be less than or equal to lte when both are present.

Force flattened/recursive search (true) or direct top-level listing (false). When omitted, it's computed from whether any of q, nodeTypes, recordTypes, origins, connectorIds, indexingStatus, createdAt, updatedAt, or size are present — if any are, results are flattened automatically; otherwise only top-level nodes are returned.

Comma-separated list of additional response sections to include. An unknown value is answered 400 ("Invalid include value(s): ..."). Maximum 100 items.

Valid values: breadcrumbs, counts, availableFilters, permissions