---
title: "Set space theme"
method: PUT
path: "/wiki/rest/api/space/{spaceKey}/theme"
tags: ["Themes"]
---

# Set space theme

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

Sets the theme for a space. Note, if you want to reset the space theme to
the default Confluence theme, use the 'Reset space theme' method instead
of this method.

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

## Path parameters

- `spaceKey` string, required

## Request body

- ThemeUpdate
  - `themeKey` string, required — The key of the theme to be set as the space theme.

## Response `200`

Returned if the theme was set for the space.

- Theme
  - `themeKey` string, required
  - `name` string
  - `description` string
  - `icon` Icon, nullable — This object represents an icon. If used as a profilePicture, this may be returned as null, depending on the user's privacy setting.
    - `path` string, required
    - `width` integer, required
    - `height` integer, required
    - `isDefault` boolean, required
  - `_links` GenericLinks

## Other responses

- `403` — Returned if the theme key is invalid.
- `404` — Returned if there is no space with the given key.

---

[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)