---
title: "Delete a Team Space folder"
method: DELETE
path: "/v1/workspaces/{workspaceId}/folders/{folderId}"
tags: ["Folders"]
---

# Delete a Team Space folder

`DELETE /v1/workspaces/{workspaceId}/folders/{folderId}`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/folders/{folderId}`
- Auth: HTTP bearer

Owners/admins for any folder; a member only for folders they created, while `members_can_create_folders` is on (otherwise 403 ADMIN_REQUIRED). Artifacts become unfiled and subfolders move to the top level.

## Response `200`

Deleted

- object
  - `success` boolean
  - `deleted` string

## Other responses

- `403`: Access denied
- `404`: Resource not found

## Changes

- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/folders/:folderId/delete.md)

---

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