---
title: "Delete Workspace File"
method: DELETE
path: "/workspaces/{workspace_id}/files"
tags: ["Workspaces"]
---

# Delete Workspace File

`DELETE /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`

Delete one exact path from a workspace and remove matching upload metadata.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `path` string, required: Relative file path to delete

## Response `204`

Successful Response

## Other responses

- `400`: Invalid request (bad session/workspace pairing or file path).
- `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)