Rename a folder
POST/folder.rename
Rename a folder by ID.
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 renamed
Bad request. Common causes:
- Missing or invalid
id(missing_parameter/invalid_parameter) - Missing or empty
name(missing_parameter), or longer than 255 characters - 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.