clickup_update_privacy_and_access
Set an object private or public, and grant or revoke user or group access with specific permission levels (read, comment, edit, create) or remove access entirely.
Instructions
Set the privacy of an object and grant/revoke user or group access (Enterprise).
Flips an object private/public and/or edits its ACL. Each entries item sets
a permission level for a user or group: 1=read, 3=comment, 4=edit, 5=create,
or null to remove that principal's access. Works across ClickUp object types
(task, list, folder, space, doc, dashboard, view, goal, …) via the
object_type/object_id pair.
Note: Enterprise plan only — returns 403 on other plans. Sharing an item may incur seat/billing charges.
When to Use:
To make a List private and grant a group edit access.
To revoke a user's access to a Doc (
permission_level: null).
When NOT to Use:
To invite someone to the whole Workspace — use the guests/users tools.
Returns: A confirmation of the privacy change and each access entry applied.
Examples:
params = {"object_type": "list", "object_id": "901300", "private": true, "entries": [{"kind": "group", "id": "88", "permission_level": 4}]}
params = {"object_type": "doc", "object_id": "8cb", "entries": [{"kind": "user", "id": "182", "permission_level": null}]}
Error Handling:
403 → not Enterprise or insufficient rights; 404 → unknown object. Errors
return an Error ... string.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |