Add new permission to space

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.

Request

Body parameters

1
2
3
4
5

'create': 'page', 'blogpost', 'comment', 'attachment'
'read': 'space'
'delete': 'page', 'blogpost', 'comment', 'attachment'
'export': 'space'
'administer': 'space'

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

curl --request POST \
  --url 'https://api.atlassian.com/ex/confluence/:cloudId:/wiki/rest/api/space/{spaceKey}/permission' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "id": 2154,
  "subject": {
    "type": "user",
    "identifier": "<string>"
  },
  "operation": {
    "key": "administer",
    "target": "page"
  },
  "_links": {}
}'

Responses

Add new custom content permission to space

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

Request

Body parameters

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

curl --request POST \
  --url 'https://api.atlassian.com/ex/confluence/:cloudId:/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
    }
  ]
}'

Responses

Remove a space permission

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.

Request

Example

1
2

curl --request DELETE \
  --url 'https://api.atlassian.com/ex/confluence/:cloudId:/wiki/rest/api/space/{spaceKey}/permission/{id}'

Responses