List folders
Lists one folder by path, every folder below path_prefix, or direct children by parent_id. Without a selector it lists root folders. Cursor paginated, never offset. A short page does not mean the end: items the key may not read are dropped after the page is read, so page until hasMore is false.
Authorizations
Workspace-scoped API key, sent as a bearer token. The recommended header. The workspace is implicit in the key and never appears in a URL.
Query Parameters
Maximum items in one page. A page may come back shorter; read hasMore, not the count.
1 <= x <= 1000A nextCursor from an earlier page. Opaque: store and echo it, never parse or construct one. A cursor belongs to the query that issued it, so changing a filter means starting again from the first page; reusing one across filters answers invalid_cursor rather than a page from the wrong collection.
Exact path to a folder. A path naming nothing is an empty collection. The root itself is not addressable here; omit every selector to list root folders.
"/support/policies"
Every folder below this folder, recursively. A prefix naming nothing is an empty collection.
"/support"
Lists folders directly inside this parent. Omit it to list root folders.
"dir_9f2k1x8b3m7q0v"
Response
A page of folders. Read hasMore before stopping.
Type discriminator. Always list.
list The collection this page came from, without the query that selected it.
"/v1/files"
Whether more items remain. A short page does not mean the end: unreadable items are dropped after the page is read. Page until this is false.
Opaque. Pass back as cursor. Present whenever hasMore is true, null on the last page.
"c_9f2k1x8b3m7q0v"
The folders on this page.