Rate this page:

Space settings

Get space settings

GET /wiki/rest/api/space/{spaceKey}/settings

Returns the settings of a space. Currently only the routeOverrideEnabled setting can be returned.

Permissions required: 'View' permission for the space.

App scope requiredREAD

OAuth scopes required
read:confluence-space.summary

Request

Path parameters
spaceKey Required

string

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

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/settings' \
  --header 'Accept: application/json'

Responses

Returned if the space settings are returned.

Content typeValue
application/json

SpaceSettings

Update space settings

PUT /wiki/rest/api/space/{spaceKey}/settings

Updates the settings for a space. Currently only the routeOverrideEnabled setting can be updated.

Permissions required: 'Admin' permission for the space.

App scope requiredWRITE

OAuth scopes required
write:confluence-space

Request

Path parameters
spaceKey Required

string

The key of the space whose settings will be updated.

Body parameters
routeOverrideEnabled

boolean

Defines whether an override for the space home should be used. This is used in conjunction with a space theme provided by an app. For example, if this property is set to true, a theme can display a page other than the space homepage when users visit the root URL for a space. This property allows apps to provide content-only theming without overriding the space home.

Example

1
2
3
4
5
6
7
curl --request PUT \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/settings' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "routeOverrideEnabled": true
}'

Responses

Returned if space settings are updated.

Content typeValue
application/json

SpaceSettings

Rate this page: