Delete Folder

Beta

Delete a folder. By default a folder that still contains documents or sub-folders is refused with 409 - pass ?force=true to delete it anyway, which recursively moves its documents to root and removes its sub-folders.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

kb_idstringRequired

Knowledge base id (prefixed external id, kb_...).

folder_idstringRequired

Knowledge-base folder id (prefixed external id, kfolder_...).

Headers

Speechify-VersionstringOptional

Query parameters

forcebooleanOptional

When true, delete the folder even if it still contains documents or sub-folders; documents are moved to root and sub-folders are removed.

Response

Folder deleted.

Errors

401
Unauthorized Error
404
Not Found Error
409
Conflict Error