Upload Workspace Files

Presigned PUT URLs for input files, placed under uploads/ in the workspace. The agent pulls them in at the start of every run. URLs are pinned to the declared Content-Type and exact Content-Length.

POST /workspaces/{workspace_id}/files/upload

Upload Workspace Files

JavaScript

const options = {
  method: 'POST',
  headers: {'X-Browser-Use-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    files: [{name: '<string>', size: 26214400, contentType: 'application/octet-stream'}],
    allowOverrides: true
  })
};

fetch('https://api.browser-use.com/api/v4/workspaces/{workspace_id}/files/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

200

{
  "files": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "storedName": "<string>",
      "path": "<string>",
      "willOverride": true,
      "uploadUrl": "<string>"
    }
  ]
}

Authorizations

X-Browser-Use-API-Key · string · header · required

Path Parameters

workspace_id · string<uuid> · required

Body

application/json

files · WorkspaceFileUploadItem · object[] · required

Required array length: 1 - 10 elements

Show child attributes

allowOverrides · boolean · default: true

When false, return 409 before reserving storage if any uploaded filename would replace an existing workspace file.

Response

200

application/json

Successful Response

files · WorkspaceFileUploadResponseItem · object[] · required

Show child attributes