Create Branding Theme

Create Branding Theme

Create a new custom theme, uniquely identified by name.

This can be used to set the theme in "/branding".

Request
URI
POST
https://{api_host}/cloudapi/branding/themes
COPY
Request Body
BrandingTheme of type(s) application/json
Optional 
{
    "id": "urn:vcloud:entity:vmware:brandinguitheme:1.0.0:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "string",
    "themeType": "string",
    "isLegacy": false,
    "isDefault": false,
    "active": false,
    "themeBase": "string",
    "logoThumbprint": "string",
    "version": "string",
    "previewStyles": "string"
}
string
id
Optional

A unique identifier for the branding theme (read-only).

string
name
Required

Display name for the Branding Theme

string
themeType
Optional

Type of the Branding Theme. Supported theme types are:

  • BUILT_IN - Theme pre-bundled with Cloud Director
  • CUSTOM - Custom Branding Theme
boolean
isLegacy
Optional

If true, the branding theme is represented in old format that can not be edited.

boolean
isDefault
Optional

If true, the branding theme is used by any organization with no explicit theme assignment.

boolean
active
Optional

If true, the branding theme is used for branding customization of the organization. Only one branding theme can be active for organization.

string
themeBase
Optional

This indicates whether the theme css is based of the light or dark css base. Missing value indicates the base is unknown. Enum options - CLARITY_LIGHT_THEME, CLARITY_DARK_THEME.

string
logoThumbprint
Optional

base64 encoded Logo thumbprint generated from the provided logo resource.

string
version
Optional

Version of the theme

string
previewStyles
Optional

Subset of the provided custom resource styles.

Authentication
This operation uses the following authentication methods.
Responses
201

Created

Returns BrandingTheme of type(s) application/json;version=38.0 
{
    "id": "urn:vcloud:entity:vmware:brandinguitheme:1.0.0:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "string",
    "themeType": "string",
    "isLegacy": false,
    "isDefault": false,
    "active": false,
    "themeBase": "string",
    "logoThumbprint": "string",
    "version": "string",
    "previewStyles": "string"
}
string
id
Optional

A unique identifier for the branding theme (read-only).

string
name
Required

Display name for the Branding Theme

string
themeType
Optional

Type of the Branding Theme. Supported theme types are:

  • BUILT_IN - Theme pre-bundled with Cloud Director
  • CUSTOM - Custom Branding Theme
boolean
isLegacy
Optional

If true, the branding theme is represented in old format that can not be edited.

boolean
isDefault
Optional

If true, the branding theme is used by any organization with no explicit theme assignment.

boolean
active
Optional

If true, the branding theme is used for branding customization of the organization. Only one branding theme can be active for organization.

string
themeBase
Optional

This indicates whether the theme css is based of the light or dark css base. Missing value indicates the base is unknown. Enum options - CLARITY_LIGHT_THEME, CLARITY_DARK_THEME.

string
logoThumbprint
Optional

base64 encoded Logo thumbprint generated from the provided logo resource.

string
version
Optional

Version of the theme

string
previewStyles
Optional

Subset of the provided custom resource styles.


Availability
Added in 30.0
Deprecated in 37.1
With alternative: see
See /cloudapi/1.0.0/brandingThemes
On This Page
Branding Operations
POST
Create Branding Theme
DELETE
Delete Branding Theme
DELETE
Delete Branding Theme Contents
DELETE
Delete System Icon
DELETE
Delete System Logo
DELETE
Delete Tenant Icon
DELETE
Delete Tenant Logo
GET
Get Branding Theme
GET
Get Branding Theme Css
GET
Get Branding Themes
GET
Get System Branding
GET
Get System Icon
GET
Get System Logo
GET
Get Tenant Branding
GET
Get Tenant Icon
GET
Get Tenant Logo
PUT
Put System Branding
PUT
Put System Icon
PUT
Put System Logo
PUT
Put Tenant Branding
PUT
Put Tenant Icon
PUT
Put Tenant Logo
DELETE
Remove Tenant Branding
PUT
Update Branding Theme
POST
Upload Branding Theme Contents