User Upload File Presigned Url | Browser Use Cloud Docs

Generate a secure presigned URL for uploading files that AI agents can use during tasks.

session_idstringRequiredformat: "uuid"

X-Browser-Use-API-KeystringRequired

This endpoint expects an object.

fileNamestringRequired>=1 character<=255 characters

The name of the file to upload

contentTypeenumRequired

The content type of the file to upload

sizeBytesintegerRequired>=1<=10485760

Successful Response

urlstring

The URL to upload the file to.

method"POST"Defaults to POST

The HTTP method to use for the upload.

fieldsmap from strings to strings

The form fields to include in the upload request.

fileNamestring

The name of the file to upload (should be referenced when user wants to use the file in a task).

expiresIninteger

The number of seconds until the presigned URL expires.

1	curl -X POST https://api.browser-use.com/api/v2/files/sessions/session_id/presigned-url \
2	-H "X-Browser-Use-API-Key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"fileName": "string",
6	"contentType": "image/jpg",
7	"sizeBytes": 1
8	}'