---
title: "DELETE /api/v1/folders/{folderId}"
method: DELETE
path: "/api/v1/folders/{folderId}"
---

# DELETE /api/v1/folders/{folderId}

`DELETE /api/v1/folders/{folderId}`

## Request

- Base URL: `https://falconer.com` (the document declares no server; this is the origin it was published from)
- URL: `https://falconer.com/api/v1/folders/{folderId}`
- Auth: none declared

## Path parameters

- `folderId` integer, required

## Headers

- `x-organization-id` string: Required when using OAuth bearer tokens.

## Response `200`

Folder removed: archived, or in a docs site or synced Space removed the way its Docs view removes it

- DeletedFolder
  - `folderId` number, required
  - `removal` 'archived' | 'unlisted' | 'deleted_files', required: archived for a normal folder. In a docs site the folder leaves the Docs view and its files stay (unlisted); in a GitHub-mirrored Space its directory is deleted (deleted_files).
  - `archived` boolean, required: Whether the folder itself was archived.
  - `archivedDocumentIds` string[], required

## Other responses

- `400`: Bad request
- `403`: Forbidden
- `404`: Folder not found

---

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