Your documents tools
Five tools to add your own files to a project, search them, get download links, and remove them.
Files you upload stay in the project and in your Sleuth workspace, and Sleuth reads them alongside the knowledge base when it runs. None of these tools use credits. Bring your own documents and data
upload_document
Upload a file to a project. Send the file’s bytes as base64.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
filename required | string | The original file name, with its extension |
content_base64 required | string | The file, base64-encoded. Up to 10 MB once decoded. |
title | string | A title for the document |
Upload files before the send_message that should use them. Larger files go in through Studio.
list_documents
List the documents in a project.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
get_document
Get a document’s details, including a download_url that expires within minutes. Fetch it right away, or present it to the user as a link.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
document_id required | string | Document UUID |
search_documents
Search the text of documents uploaded to a project. A document uploaded moments ago may not match yet while Sleuth indexes it.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
query required | string | A question or topic in plain words |
document_ids | string[] | Limit the search to these documents |
top_k | integer | 1 to 50, default 10 |
delete_document
Delete a document from a project.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
document_id required | string | Document UUID |
Updated November 9, 2026