Delete a folder (async, cascades)
Header Parameters
Path Parameters
Stable folder ID. Unchanged by rename or move. Unknown, malformed, or cross-tenant → 404 FOLDER_NOT_FOUND.
Body Parameters
Show child attributes
Response
Delete queued for async processing. Poll
GET /v2/admin/jobs/{jobId} using data.id (kind: folder.delete).
Response Attributes
Show child attributes
reason / extraDetails is invalid, or reason is missing while the tenant requires one.
Response Attributes
Show child attributes
Access token is missing or invalid.
Response Attributes
Show child attributes
Authenticated but not permitted — caller is not an admin/super-admin, or the endpoint's feature permission is off.
Response Attributes
Show child attributes
{folderId} not visible to this caller (unknown, malformed, or in another tenant).
Response Attributes
Show child attributes
The folder is in use (FOLDER_IN_USE), changed under the request (FOLDER_CONFLICT; safe to retry), data.id does not match {folderId}, or data.type is not folder.
Response Attributes
Show child attributes
Request Content-Type is not application/vnd.api+json.
Response Attributes
Show child attributes
The tenant root cannot be deleted, or the subtree has more than 500 documents.
Response Attributes
Show child attributes
Too many requests; retry later.
Response Attributes
Show child attributes
Unexpected server error.