Tool
get_files · Behavior Read-onlyid to fetch one file (and poll its upload status), q to search files you can access (optionally narrowed by scope), or project_id to list a project’s files (add q to search within them). Always returns a files array — empty when nothing matches. Calling with none of id, q, or project_id is an error: there is no full file listing, only lookup, search, and per-project listing.
Input parameters
string (uuid)
Fetch one file by id. This is also the upload-readiness poll: the returned file carries
status (ready once processing finishes). Cannot be combined with q or project_id.string
Search across files you can access, ranked by relevance (max 100 results). Combine with
project_id to search within one project.'my-files' | 'shared-with-me' | 'organization'
Optional search scope filter: “my-files”, “shared-with-me”, or “organization”. Applies to
q searches only.string (uuid)
Restrict to files in this project (e.g. a project holding a set of contracts). Alone, lists the project’s files; with
q, searches within them. Cannot be combined with id or scope.Response
object[]
string
Plain-language next step for a single-file lookup (ready to use, still processing so poll again, or failed). Absent for searches and multi-file results.