Remove folder members

POST 
/folder.removeMembers

Remove up to 100 people from a folder. They lose the access the folder gave them. Removing the last admin returns 409 conflict; promote someone else with folder.addMembers first.

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

Members removed

400

Bad request. Common causes:

• Missing or invalid id (missing_parameter / invalid_parameter)
• Missing or empty userIds, more than 100 IDs, or an ID that is not a UUID (missing_parameter / invalid_parameter)
• Malformed JSON body or an unknown field (invalid_json)

401

Presented invalid authentication credentials.

403

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)

404

Not found. Common causes:

• Folder not found, or not visible to the caller (folder_not_found)

405

An unsupported method was requested.

409

The change would leave the folder without an admin (conflict).

500

An internal error occurred.