v1
latestOpenAPI 3.1.02026-07-24172151607.6 KBAcls
Privacy and access
Update privacy and access of an object or location
Update the privacy and access settings of an object or location in the Workspace. Note that sharing an item may incur charges.
patch/api/v3/workspaces/{workspace_id}/{object_type}/{object_id}/acls
Path parameters
workspace_idnumber required
The ID of the Workspace.
object_type'approval' | 'attachment' | 'attachmentAccess' | 'banWorkspace' | 'checklist' | 'checklistItem' | 'checklistTemplateAccess' | 'comment' | 'commentThread' | 'commentsLastReadAt' | 'customField' | 'customFieldAccess' | 'customItem' | 'customPermissionLevel' | 'dashboard' | 'dashboardAccess' | 'doc' | 'docAccess' | 'folder' | 'folderDescendantsSet' | 'folderTemplateAccess' | 'form' | 'formulaValue' | 'foundationalJob' | 'goal' | 'goalAccess' | 'goalFolder' | 'goalFolderAccess' | 'hierarchy' | 'list' | 'listDescendantsPoints' | 'listDescendantsSet' | 'listDescendantsTimeEstimates' | 'listTemplateAccess' | 'notepad' | 'page' | 'pageAccess' | 'post' | 'reminder' | 'reminderAccess' | 'rolledUpFieldValue' | 'scheduledComment' | 'space' | 'spaceDescendantsSet' | 'spaceTemplateAccess' | 'task' | 'taskAccess' | 'taskHistory' | 'taskProperty' | 'taskTemplateAccess' | 'template' | 'user' | 'userAccess' | 'userGroup' | 'userHierarchy' | 'userPresence' | 'view' | 'viewAccess' | 'viewTemplateAccess' | 'whiteboard' | 'whiteboardAccess' | 'widget' | 'workscheduleScheduleExceptions' | 'workscheduleWorkweekSchedule' | 'workspace' | 'workspaceDescendantsSet' required
Any object that can be shared in a Workspace. For example, customField, dashboard, folder, goal, goalFolder, list, space, task, and view.
ObjectType
object_idstring required
The ID of the object to share.