clickup_update_privacy_and_access
Control object privacy and manage user/group access permissions for ClickUp items. Grant or revoke read, comment, edit, create, or remove access on tasks, lists, docs, and more.
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 |