---
title: "Uploads"
description: "Upload a local file."
---

> Documentation Index
> Fetch the complete documentation index at: https://help.tooluse.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Uploads

<p>The native upload endpoint accepts multipart form data for a running session. Each file must be at most 512 KiB, with at most 16 files per session. The Cloudflare Containers transport currently refuses this capability.</p>
<pre><code class="language-bash">curl -X POST "https://api.tooluse.net/v1/browsers/sessions/$SESSION_ID/uploads" \
  -H "Authorization: Bearer $TOOLUSE_API_KEY" \
  -F "file=@./example.txt"
</code></pre>
<p>The response contains <code>remotePath</code>. Use that remote path with the file-input operation of your CDP automation client; a path on your own computer is not a remote path. Uploaded files are ephemeral and removed when the session ends.</p>

Source: https://help.tooluse.net/browsers/files/uploads/index.mdx