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…
One file or folder by its path, without listing the folder around it (404 not found, 409 ambiguous_path)
Returns one file or folder by its path, for example /photos/2026/a.jpg, without listing the folder around it. 404 not_found when nothing is there; 409 ambiguous_path when more than one item has that path. Needs files:read.
Do this with AI
I want to one file or folder by its path, without listing the folder around it (404 not found, 409 ambiguous_path). Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/getfilebypath.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/files/by-pathcurl --request GET \
--url 'https://tarkle.com/api/v1/files/by-path?path=path' \
--header 'Authorization: Bearer $API_KEY' \
--header 'X-Workspace-Key: X-Workspace-Key'Query parameters
pathstringrequiredA path such as /photos/2026/a.jpg
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)