---
title: "Delete a workspace file"
method: DELETE
path: "/api/workspace/files/{file_id}"
tags: ["workspace"]
---

# Delete a workspace file

`DELETE /api/workspace/files/{file_id}`

Soft-delete a workspace file and attempt to remove it from storage.

Used when a user clears a file input in the builder.

## Path parameters

- `file_id` string, required

## Response `200`

Successful Response

- DeleteFileResponse
  - `deleted` boolean, required

## Other responses

- `401` — Authentication required
- `422` — Validation Error

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)