Delete a folder

View as Markdown

Soft-deletes (archives) an empty folder. Refuses a non-empty folder (contained subfolders, files, or pending reservations) with 409. Requires file:delete on the project.

Authentication

AuthorizationBearer

WorkOS session JWT or an organization API key, sent as Authorization: Bearer <token>.

Path parameters

projectIdstringRequired
folderIdstringRequired

Response

The folder was archived.
okboolean

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error