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.

Ask a question about the files and get an answer with sources (body: question, folder, mode)

Answers one question from the workspace's files, written by the same code as Ask about files in the app, and returns { answer, sources, credits_used, paid_by, mode, notes }. In answer the files are cited as [1], [2]; sources lists them with file_id (the files API's id, null when unknown), name and pages. Body: question (required, up to 4000 characters), history (optional, up to 20 earlier messages of {role, content}, oldest first, for a follow-up), folder (a folder id: only that folder and its subfolders are read), mode (basic, the default, or deep: slower and thorough, Pro plans and organizations with their own AI key). It only reads: nothing is changed, nothing is saved: each call is a separate question unless you send history. Only files the token's person can open are read. THIS SPENDS AI CREDITS exactly like a question in the app (the plan's credits, extra credits, or the organization's own AI key): credits_used says how many; when the credits for the period are used the call is 429 ai_budget, and a person asking far too fast gets 429 slow_down. A call can run for minutes (up to 5), so set a long client timeout. Search and reading with no credits: searchFiles and getFileText. It counts as an AI request: 1 unit of the daily quota and the plan's search and AI limit a minute per key (its real cost is the credits above). Needs ai:ask; a token made before this scope existed does not have it, so make a new one in Settings > API.

What you provide

  • Question: What to ask about the files. Each call is a separate question: nothing from an earlier call is remembered.
  • Folderoptional: Only answer from this folder and its subfolders
  • Modeoptional: deep is slower and thorough; Pro plans and organizations with their own AI key only
  • Historyoptional: Earlier questions and answers of this conversation, oldest first, so a follow-up makes sense; each is charged as input

Do this with AI

I want to ask a question about the files and get an answer with sources (body: question, folder, mode). Use the Tarkle API. Read the reference for this operation and follow it exactly: https://project-03b42162.restlessdocs.com/endpoint/askfiles.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.