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.

Servers

Path parameters

Name Type Required Description
spaceKey String Yes

The key of the space to be queried for its content.

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/json"

Request body fields

Name Type Required Description
_links Object No
_links.Embeddable Object No
_links.ContentId String No
operation Object Yes
operation.key String Yes

Possible values:

  • "purge"
  • "copy"
  • "delete"
  • "administer"
  • "archive"
  • "use"
  • "export"
  • "restrict_content"
  • "read"
  • "restore"
  • "create"
  • "move"
  • "update"
  • "purge_version"
operation.target String Yes

The space or content type that the operation applies to.

Possible values:

  • "attachment"
  • "space"
  • "blogpost"
  • "comment"
  • "page"
subject Object Yes

The user or group that the permission applies to.

subject.identifier String Yes

for type=user, identifier should be user's accountId or anonymous for anonymous users

for type=group, identifier should be the groupId.

subject.type String Yes

Possible values:

  • "group"
  • "user"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.