---
title: "Update space settings"
method: PUT
path: "/wiki/rest/api/space/{spaceKey}/settings"
tags: ["Space settings"]
---

# Update space settings

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

Updates the settings for a space.

**[Permissions](https://confluence.atlassian.com/x/_AozKw) required**:
'Admin' permission for the space.

## Path parameters

- `spaceKey` string, required

## Request body

- SpaceSettingsUpdate
  - `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.
  - `contentMode` 'standard' | 'compact', nullable — The content rendering mode for the space. Controls spacing and typography in the editor and renderer. Valid values are "standard" and "compact". When set to "compact", content is rendered more densely with smaller spacing and typography.

## Response `200`

Returned if space settings are updated.

- SpaceSettings, nullable
  - `routeOverrideEnabled` boolean, required — 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.
  - `editor` object
    - `page` string, required
    - `blogpost` string, required
    - `default` string, required
  - `contentMode` 'standard' | 'compact', nullable — The content rendering mode for the space. Controls spacing and typography in the editor and renderer. Valid values are "standard" and "compact". When set to "compact", content is rendered more densely with smaller spacing and typography.
  - `spaceKey` string
  - `_links` GenericLinks, required

## Other responses

- `401` — Returned if the authentication credentials are incorrect or missing from the request.
- `404` — Returned if; - There is no space with the given key. - The calling user does not have permission to update the space.

---

[API](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api.md) · [All operations](https://skmtc.net/atlassian/apis/the-confluence-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/the-confluence-cloud-rest-api/revisions/70088490f406/schema)