---
title: "Delete Workspace File"
method: DELETE
path: "/agent/workspace/files/{file_path}"
---

# Delete Workspace File

`DELETE /agent/workspace/files/{file_path}`

## Request

- Base URL: `https://app.runconverge.com/api`
- URL: `https://app.runconverge.com/api/agent/workspace/files/{file_path}`
- Auth: none declared

## Path parameters

- `file_path` string, required

## Query parameters

- `recursive` boolean
- `experimental_version` string, nullable
- `volume_override` string, nullable

## Headers

- `Authorization` string, nullable
- `X-User-Id` string, nullable
- `X-Posthog-Session-Id` string

## Cookies

- `session_id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-28** `7c3270848bed`: 1 info
  - added the new optional `header` request parameter `X-Posthog-Session-Id`

[Operation history](https://skmtc.dev/runconverge/apis/runconverge-api/changes/agent/workspace/files/:file_path/delete.md)

---

[API](https://skmtc.dev/runconverge/apis/runconverge-api.md) - [All operations](https://skmtc.dev/runconverge/apis/runconverge-api/llms.txt) - [OpenAPI document](https://skmtc.dev/runconverge/apis/runconverge-api/revisions/f723e951cc0b?raw)