For AI agents: a machine-readable documentation index for this API is available at /llms.txt. Every page is also available as Markdown: append ".md" to the URL or send an "Accept: text/markdown" request header.

List the files and folders inside a folder of the library (folders first, then files; the root by default)

In a workspace with admin privacy on, an ADMIN token never sees private items it cannot open: `locked_count` says how many private folders were left out, and include_locked=true lists them as bare placeholders ({id, type, name, parent_id, locked: true, visibility: private}); opening one answers 403 private_item. Lists what is inside one folder: folders first, then files, each in id order so a cursor never skips or repeats an entry. The library root is the default; pick another folder with folder (a folder id) or path (for example /photos/2026), not both. With recursive=true and a type, every descendant comes back as one flat list with absolute paths (a subtree above 5,000 folders is refused with 413 too_large). Page with limit and next_cursor. Needs files:read.

Do this with AI

I want to list the files and folders inside a folder of the library (folders first, then files; the root by default). Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/listfiles.md Authenticate with your API key as a Bearer token in the Authorization header. Then make the request for me and tell me what came back.

Paste this into Claude, Cursor, or any AI assistant and it will do it for you.