Start free
Tools

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.

InputTypeNotes
project_id requiredstringProject UUID
filename requiredstringThe original file name, with its extension
content_base64 requiredstringThe file, base64-encoded. Up to 10 MB once decoded.
titlestringA 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.

InputTypeNotes
project_id requiredstringProject 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.

InputTypeNotes
project_id requiredstringProject UUID
document_id requiredstringDocument 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.

InputTypeNotes
project_id requiredstringProject UUID
query requiredstringA question or topic in plain words
document_idsstring[]Limit the search to these documents
top_kinteger1 to 50, default 10

delete_document

Delete a document from a project.

InputTypeNotes
project_id requiredstringProject UUID
document_id requiredstringDocument UUID