---
title: "List Workspace Files"
method: GET
path: "/workspaces/{workspace_id}/files"
tags: ["Workspaces"]
---

# List Workspace Files

`GET /workspaces/{workspace_id}/files`

## Request

- Base URL: `https://api.browser-use.com/api/v4`
- URL: `https://api.browser-use.com/api/v4/workspaces/{workspace_id}/files`
- Auth: API key in header `X-Browser-Use-API-Key`

List files the agent has produced for this workspace, paginated.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `prefix` string
- `limit` integer
- `cursor` string, nullable
- `includeUrls` boolean
- `contentDisposition` 'attachment', nullable

## Response `200`

Successful Response

- WorkspaceFileListResponse
  - `files` WorkspaceFileInfo[], required
    - `path` string, required: File path relative to the workspace root
    - `size` integer, required: File size in bytes
    - `lastModified` string, date-time, required: When the file was last modified
    - `url` string, nullable: Presigned download URL (60s expiry). Only included when `includeUrls=true`.
  - `nextCursor` string, nullable
  - `hasMore` boolean

## Other responses

- `400`: Malformed pagination cursor.
- `403`: Zero Data Retention is enabled on the project (V4 unsupported).
- `404`: Run, session, workspace, or profile not found.
- `422`: Validation Error

---

[API](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4.md) · [All operations](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/llms.txt) · [OpenAPI document](https://skmtc.dev/browser-use/apis/browser-use-public-api-v4/revisions/cd7b1eee1102?raw)