> ## Documentation index
> Fetch the complete documentation index at: [llms.txt](../llms.txt)
> Use this file to discover all available pages before exploring further.

# 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](own-data.md)

### `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 |

## Related

- [Use your own documents and data](own-data.md): Upload files for Sleuth to read, start from your own spreadsheet, or have Sleuth source the values you already have.
- [Projects and runs tools](tools-projects.md): Nine tools to create projects, ask research questions, follow runs, approve plans, and read Sleuth’s answers.
- [Your data in AI tools](ai-tools-data.md): What travels between your AI tool and Sleuth when you connect them.

*Updated November 9, 2026.*
