Update content access for members

Create or update explicit content access entries for one or more users or groups on a specific TeamSite item. The item can be TeamSite home (itemId: root), a folder, or a file.

Content Access Permissions

Content Access Permissions are enforced at the TeamSite root, folder, and file level and support these permission ids:
403 (CanView): View, comment, and approve content.
404 (CanEdit): Edit and add folders, and edit, add, publish, or move files.
405 (CanManage): Edit, add, publish, move, delete, and manage content access.

Domain Terms

  • addContentAccessPermissions: Members and permission ids to add who do not already have an explicit access entry on the target item.
  • modifyContentAccessPermissions: Existing explicit access entries whose permission level should be changed.
  • contentAccessNotify: Optional notification configuration applied after the access update succeeds; subscribers receive a message only when needNotify is true.
  • Full-control members: Members whose access entry cannot be added, modified, or removed by this API.

Validation Rules

  1. The caller must have CanManage on the target item.
  2. Updating member access at TeamSite root additionally requires CanManage on root.
  3. Full-control members cannot be added or modified.
  4. When the library-content-access-updates feature toggle is enabled, TeamSite owner access cannot be modified.
  5. Each member entry must specify exactly one permission id from 403, 404, or 405.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

TeamSite identifier for the access update context. Accepts a GUID value or the special value 1 for the default TeamSite.

string
required

Content item identifier to update. Accepts a GUID value or the special value root for TeamSite home.

Body Params

Members to add or modify, and optional notification preferences for this update.

Request payload for adding or modifying explicit content access entries.

addContentAccessPermissions
array of objects

Members and permissions to add on the target content.

addContentAccessPermissions
modifyContentAccessPermissions
array of objects

Existing members whose permissions should be updated.

modifyContentAccessPermissions
contentAccessNotify
object

Notification settings for content access changes.

Responses

403 in legacy environments.

403; clients should handle both 401 and 403 for auth-related failures.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json