Workspaces & files

Persist files across V4 runs and conversations.

A workspace is a persistent filesystem shared by runs—even runs in different sessions. Use it for inputs, scripts, and generated files.

Upload and attach a file

Python

from browser_use_sdk.v4 import BrowserUse

client = BrowserUse()
workspace = client.workspaces.create(name="research")
uploaded = client.workspaces.upload(workspace.id, "people.csv")

run = client.runs.create(
    "Find everyone in the CSV who works at Google",
    workspace_id=workspace.id,
    attached_file_ids=[uploaded[0].id],
)

import { BrowserUse } from "browser-use-sdk/v4";

const client = new BrowserUse();
const workspace = await client.workspaces.create({
  name: "research",
});
const uploaded = await client.workspaces.upload(
  workspace.id,
  "people.csv",
);

const run = await client.runs.create({
  task: "Find everyone in the CSV who works at Google",
  model: "grok-4.5",
  workspaceId: workspace.id,
  attachedFileIds: [uploaded[0].id],
});

Attachments are run-scoped. Reusing a workspace does not reattach every upload.

Retrieve created files

Ask the agent to save its output, then list the workspace:

Python

files = client.workspaces.files(
    workspace.id,
    include_urls=True,
)
for file in files.files:
    print(file.path, file.url)

const files = await client.workspaces.files(
  workspace.id,
  { includeUrls: true },
);
for (const file of files.files) {
  console.log(file.path, file.url);
}

Download URLs expire after 60 seconds. See the workspace API reference for pagination and limits.