• 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

Themes

Postman Collection
OpenAPI
GET

Get themes

Returns all themes, not including the default theme.

Permissions required: None

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

ClassicRECOMMENDED:manage:confluence-configuration
Granular:read:configuration:confluence

Request

Query parameters

start

integer

limit

integer

Responses

Returned if the requested themes are returned.

application/json

ThemeArray
GET/wiki/rest/api/settings/theme
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/settings/theme`, { 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 11 12 13 14 15 16 17 18 19 { "results": [ { "themeKey": "<string>", "name": "<string>", "description": "<string>", "icon": { "path": "<string>", "width": 2154, "height": 2154, "isDefault": true } } ], "start": 2154, "limit": 2154, "size": 2154, "_links": {} }
GET

Get global theme

Returns the globally assigned theme.

Permissions required: None

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

ClassicRECOMMENDED:manage:confluence-configuration
Granular:read:configuration:confluence

Request

This request has no parameters.

Responses

Returned if the global theme is returned.

application/json

Theme
GET/wiki/rest/api/settings/theme/selected
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/settings/theme/selected`, { 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 11 12 { "themeKey": "<string>", "name": "<string>", "description": "<string>", "icon": { "path": "<string>", "width": 2154, "height": 2154, "isDefault": true }, "_links": {} }
GET

Get theme

Returns a theme. This includes information about the theme name, description, and icon.

Permissions required: None

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredREAD

ClassicRECOMMENDED:manage:confluence-configuration
Granular:read:configuration:confluence

Request

Path parameters

themeKey

string

Required

Responses

Returned if the requested theme is returned.

application/json

Theme
GET/wiki/rest/api/settings/theme/{themeKey}
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/settings/theme/{themeKey}`, { 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 11 12 { "themeKey": "<string>", "name": "<string>", "description": "<string>", "icon": { "path": "<string>", "width": 2154, "height": 2154, "isDefault": true }, "_links": {} }
GET

Get space theme

Returns the theme selected for a space, if one is set. If no space theme is set, this means that the space is inheriting the global look and feel settings.

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 requested theme is returned.

application/json

Theme
GET/wiki/rest/api/space/{spaceKey}/theme
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}/theme`, { 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 11 12 { "themeKey": "<string>", "name": "<string>", "description": "<string>", "icon": { "path": "<string>", "width": 2154, "height": 2154, "isDefault": true }, "_links": {} }
PUT

Set space 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 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

themeKey

string

Required

Responses

Returned if the theme was set for the space.

application/json

Theme
PUT/wiki/rest/api/space/{spaceKey}/theme
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 = `{ "themeKey": "<string>" }`; const response = await api.asUser().requestConfluence(route`/wiki/rest/api/space/{spaceKey}/theme`, { 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 11 12 { "themeKey": "<string>", "name": "<string>", "description": "<string>", "icon": { "path": "<string>", "width": 2154, "height": 2154, "isDefault": true }, "_links": {} }
DEL

Reset space theme

Resets the space theme. This means that the space will inherit the global look and feel settings

Permissions required: 'Admin' permission for the space.

Data Security Policy: Exempt from app access rules
Scopes

Connect app scope requiredDELETE

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

Request

Path parameters

spaceKey

string

Required

Responses

Returned if the theme was reset for the space.

DEL/wiki/rest/api/space/{spaceKey}/theme
1 2 3 4 5 6 7 8 9 10 // 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}/theme`, { method: 'DELETE' }); console.log(`Response: ${response.status} ${response.statusText}`); console.log(await response.text());

Rate this page: