Rate this page:
POST /wiki/rest/api/space/{spaceKey}/permission
Adds new permission to space.
If the permission to be added is a group permission, the group can be identified by its group name or group id.
Note: Apps cannot access this REST resource - including when utilizing user impersonation.
Permissions required: 'Admin' permission for the space.
Connect apps cannot access this REST resource.
string
The key of the space to be queried for its content.
This object represents the request for the single space permission. Permissions consist of at least one operation object with an accompanying subjects object.
The following combinations of operation.key and operation.target values are
valid for the operation object:
1 2 3 4 5 6 7
'create': 'page', 'blogpost', 'comment', 'attachment'
'read': 'space'
'delete': 'page', 'blogpost', 'comment', 'attachment', 'space'
'export': 'space'
'administer': 'space'
'archive': 'page'
'restrict_content': 'space'For example, to enable Delete Own permission, set the operation object to the following:
1 2 3 4
"operation": {
"key": "delete",
"target": "space"
}To enable Add/Delete Restrictions permissions, set the operation object to the following:
1 2 3 4
"operation": {
"key": "restrict_content",
"target": "space"
}The user or group that the permission applies to.
anything
Extra properties of any type may be provided to this object.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
curl --request POST \
--url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/permission' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"subject": {
"type": "user",
"identifier": "<string>"
},
"operation": {
"key": "administer",
"target": "page"
},
"_links": {}
}'Returned if the requested content is returned.
| Content type | Value |
|---|---|
| application/json |
POST /wiki/rest/api/space/{spaceKey}/permission/custom-content
Adds new custom content permission to space.
If the permission to be added is a group permission, the group can be identified by its group name or group id.
Note: Only apps can access this REST resource and only make changes to the respective app permissions.
Permissions required: 'Admin' permission for the space.
Connect app scope required: WRITE
string
The key of the space to be queried for its content.
This object represents a list of space permissions for custom content type for an individual user. Permissions consist of a subjects object and a list with at least one operation object.
The user or group that the permission applies to.
Array<object>
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
curl --request POST \
--url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/permission/custom-content' \
--header 'Content-Type: application/json' \
--data '{
"subject": {
"type": "user",
"identifier": "<string>"
},
"operations": [
{
"key": "read",
"target": "<string>",
"access": true
}
]
}'Returned if the requested content is returned.
A schema has not been defined for this response code.
DELETE /wiki/rest/api/space/{spaceKey}/permission/{id}
Removes a space permission. Note that removing Read Space permission for a user or group will remove all the space permissions for that user or group.
Note: Apps cannot access this REST resource - including when utilizing user impersonation.
Permissions required: 'Admin' permission for the space.
Connect apps cannot access this REST resource.
string
The key of the space to be queried for its content.
integer
Id of the permission to be deleted.
1 2
curl --request DELETE \
--url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/permission/{id}'Permission successfully removed.
A schema has not been defined for this response code.
Rate this page: