• Audit
  • Analytics
  • Content
  • Content - attachments
  • Content body
  • Content - children and descendants
  • Content - macro body
  • Content comments
  • Content labels
  • Content permissions
  • Content properties
  • Content restrictions
  • Content states
  • Content versions
  • Content watches
  • Dynamic modules
  • Experimental
  • Group
  • Inline tasks
  • Label info
  • Long-running task
  • Relation
  • Settings
  • Space
  • Space permissions
  • Space properties
  • Space settings
  • Template
  • Themes
  • Users
  • User properties
Cloud
Confluence Cloud / Reference / REST API

Space settings

Postman Collection
OpenAPI
GET

Get space settings

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

Permissions required: 'View' permission for the space.

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

ClassicRECOMMENDED:read:confluence-space.summary
Granular:read:space.setting:confluence

Request

Path parameters

spaceKey

string

Required

Responses

Returned if the space settings are returned.

application/json

SpaceSettings
Nullable: true
GET/wiki/rest/api/space/{spaceKey}/settings
1 2 3 4 5 6 7 8 9 10 11 12 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; const response = await api.asUser().requestConfluence(route`/wiki/rest/api/space/{spaceKey}/settings`, { headers: { 'Accept': 'application/json' } }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 { "routeOverrideEnabled": true, "editor": { "page": "<string>", "blogpost": "<string>", "default": "<string>" }, "spaceKey": "<string>", "_links": {} }
PUT

Update space settings

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

Permissions required: 'Admin' permission for the space.

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredWRITE

ClassicRECOMMENDED:write:confluence-space
Granular:read:space.setting:confluence, write:space.setting:confluence

Request

Path parameters

spaceKey

string

Required

Request bodyapplication/json

The space settings to update.

routeOverrideEnabled

boolean

Responses

Returned if space settings are updated.

application/json

SpaceSettings
Nullable: true
PUT/wiki/rest/api/space/{spaceKey}/settings
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 // This sample uses Atlassian Forge // https://developer.atlassian.com/platform/forge/ import api, { route } from "@forge/api"; var bodyData = `{ "routeOverrideEnabled": true }`; const response = await api.asUser().requestConfluence(route`/wiki/rest/api/space/{spaceKey}/settings`, { method: 'PUT', headers: { 'Accept': 'application/json', 'Content-Type': 'application/json' }, body: bodyData }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.json());
200Response
1 2 3 4 5 6 7 8 9 10 { "routeOverrideEnabled": true, "editor": { "page": "<string>", "blogpost": "<string>", "default": "<string>" }, "spaceKey": "<string>", "_links": {} }

Rate this page: