Delete a folder
POST/folder.delete
Delete a folder. Members lose the access the folder gave them; the meetings and Magicasts filed in it are not deleted, and anyone who could see an item another way keeps that access.
Access: Organization and Personal. Personal tokens need the admin role
on the folder: a viewer gets 403 access_denied, and a folder the token's
owner does not belong to returns 404 folder_not_found. Organization
tokens can change every folder in the account.
Required scope: folders:write
OpenAPI Spec: chat-v1.json
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 405
- 500
Folder deleted
Bad request. Common causes:
- Missing or invalid
id(missing_parameter/invalid_parameter) - Malformed JSON body or an unknown field (
invalid_json)
Presented invalid authentication credentials.
Forbidden. Common causes:
- Token is missing
folders:write(missing_scope) - Personal token whose owner is a viewer, not an admin, of the folder (
access_denied)
Not found. Common causes:
- Folder not found, or not visible to the caller (
folder_not_found)
An unsupported method was requested.
An internal error occurred.