Hey, human!
HTTP/2 200 OK content-type: text/markdown; charset=utf-8 vary: accept, user-agent x-agent: [ai_agent]
Loading the agent response…
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.
https://tarkle.com/api/v1/filescurl --request GET \
--url https://tarkle.com/api/v1/files \
--header 'Authorization: Bearer $API_KEY' \
--header 'X-Workspace-Key: X-Workspace-Key'Query parameters
cursorstringnext_cursor from the previous page. Opaque: do not build or parse it
folderstring · uuidA folder id (uuid); omit for the root. Not together with path
limitinteger1 to 1000, default 100
pathstringA path of folder names such as /photos/2026. Not together with folder
recursivebooleantrue to list EVERY descendant as one flat list with absolute paths (needs type); a subtree above 5,000 folders is refused
typestringfile or folder; required with recursive=true
workspace_keystringThe same key as the X-Workspace-Key header, for clients that cannot set headers. Send one of the two, or both with the same value (different values are 400 conflicting_workspace)
Header parameters
X-Workspace-KeystringrequiredThe 8-character key of the workspace this call acts on; GET /workspaces lists the keys a token can use. A workspace id is refused (400 workspace_key_required)