Update restrictions
Changed onUpdates restrictions for a piece of content. For each operation in the request, the supplied user and group lists replace the corresponding existing lists. Omitted operations and omitted user or group lists are preserved. An explicitly empty list ({"results": []} or []) clears that list.
Use read for viewing restrictions and update for editing restrictions. While content remains view restricted, an editor must also be able to view it. Removing an editor's read restriction while retaining their update restriction returns 400. Remove their update restriction too, or clear all read restrictions to remove direct viewing restrictions. Restrictions inherited from ancestors still apply.
Permissions required: Permission to edit the content.
Request
- Base URLhttps://your-domain.atlassian.net
- URLhttps://your-domain.atlassian.net/wiki/rest/api/content/{id}/restriction
- Auth
- HTTP basic
- or OAuth 2Authorization code: https://auth.atlassian.com/authorizeToken URL: https://auth.atlassian.com/oauth/token scopes: write:confluence-content
Path parameters
The ID of the content to update restrictions for.
Query parameters
A multi-value parameter indicating which properties of the content restrictions (returned in response) to expand.
- restrictions.user returns the users that the restrictions apply to. Expanded by default.
- restrictions.group returns the groups that the restrictions apply to. Expanded by default.
- content returns the piece of content that the restrictions are applied to.
Request body
Response
Returned if the requested restrictions are updated.
Changes
- breaking
removed
subschema #1subschema #2from the request bodyoneOflist - info
added
subschema #1subschema #2to the request bodyoneOflist - info
added the non-success response with the status
- breaking