ATatlassian
Space Roles

Create a space role

Create a space role.

Available on tenants with Role-Based Access Control.

Permissions required: User must be an organization or site admin. Connect and Forge app users are not authorized to access this resource.

post/space-roles

Request

  • Base URL
    https://no-default/wiki/api/v2
  • URL
    https://no-default/wiki/api/v2/space-roles
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: write:configuration:confluence

Request body

namestring required

Name of the space role

descriptionstring required

Description for the space role

spacePermissionsstring[] required

The ids of the space permissions associated with the space role. Sample value "read/space"; retrieve ids from responses returned by GET /space-permissions endpoint

Response

Returned if the requested space role is created.

idstring

The identifier for the space role.

type'SYSTEM' | 'CUSTOM'

The role type.

namestring

The name for the space role.

descriptionstring

The description for the space role’s usage.

spacePermissionsstring[]

The space permissions the space role is comprised of.

Changes

No recorded changes to this operation across all 5 revisions of this API.