themes

Creates, updates, deletes, gets or lists a themes resource.

Overview

Name	themes
Type	Resource
Id	okta.brands.themes

Fields

The following fields are returned by SELECT queries:

list_brand_themes

Successfully returned the list of themes

Name	Datatype	Description
id	string
_links	object	Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations.
backgroundImage	string
emailTemplateTouchPointVariant	string	Variant for email templates. You can publish a theme for email templates with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
endUserDashboardTouchPointVariant	string	Variant for the Okta End-User Dashboard. You can publish a theme for end-user dashboard with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
errorPageTouchPointVariant	string	Variant for the error page. You can publish a theme for error page with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
favicon	string
loadingPageTouchPointVariant	string	Variant for the Okta loading page. You can publish a theme for Okta loading page with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
logo	string
primaryColorContrastHex	string	Primary color contrast hex code
primaryColorHex	string	Primary color hex code
secondaryColorContrastHex	string	Secondary color contrast hex code
secondaryColorHex	string	Secondary color hex code
signInPageTouchPointVariant	string	Variant for the Okta sign-in page. You can publish a theme for sign-in page with different combinations of assets. Variants are preset combinations of those assets. > Note: For a non-OKTA_DEFAULT variant, primaryColorHex is used for button background color and primaryColorContrastHex is used to optimize the opacity for button text.

get_brand_theme

Successfully retrieved the theme

Name	Datatype	Description
id	string
_links	object	Specifies link relations (see Web Linking) available using the JSON Hypertext Application Language specification. This object is used for dynamic discovery of related resources and lifecycle operations.
backgroundImage	string
emailTemplateTouchPointVariant	string	Variant for email templates. You can publish a theme for email templates with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
endUserDashboardTouchPointVariant	string	Variant for the Okta End-User Dashboard. You can publish a theme for end-user dashboard with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
errorPageTouchPointVariant	string	Variant for the error page. You can publish a theme for error page with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
favicon	string
loadingPageTouchPointVariant	string	Variant for the Okta loading page. You can publish a theme for Okta loading page with different combinations of assets. Variants are preset combinations of those assets. (default: OKTA_DEFAULT)
logo	string
primaryColorContrastHex	string	Primary color contrast hex code
primaryColorHex	string	Primary color hex code
secondaryColorContrastHex	string	Secondary color contrast hex code
secondaryColorHex	string	Secondary color hex code
signInPageTouchPointVariant	string	Variant for the Okta sign-in page. You can publish a theme for sign-in page with different combinations of assets. Variants are preset combinations of those assets. > Note: For a non-OKTA_DEFAULT variant, primaryColorHex is used for button background color and primaryColorContrastHex is used to optimize the opacity for button text.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_brand_themes	select	subdomain		Lists all the themes in your brand. > Important: Currently each org supports only one theme, therefore this contains a single object only.
get_brand_theme	select	subdomain		Retrieves a theme for a brand
replace_brand_theme	replace	subdomain, data__primaryColorHex, data__secondaryColorHex, data__signInPageTouchPointVariant, data__endUserDashboardTouchPointVariant, data__errorPageTouchPointVariant, data__emailTemplateTouchPointVariant		Replaces a theme for a brand
upload_brand_theme_background_image	exec	subdomain, file		Uploads and replaces the background image for the theme. The file must be in PNG, JPG, or GIF format and less than 2 MB in size.
delete_brand_theme_background_image	exec	subdomain		Deletes a theme background image
upload_brand_theme_favicon	exec	subdomain, file		Uploads and replaces the favicon for the theme
delete_brand_theme_favicon	exec	subdomain		Deletes a theme favicon. The theme will use the default Okta favicon.
upload_brand_theme_logo	exec	subdomain, file		Uploads and replaces the logo for the theme. The file must be in PNG, JPG, or GIF format and less than 100kB in size. For best results use landscape orientation, a transparent background, and a minimum size of 300px by 50px to prevent upscaling.
delete_brand_theme_logo	exec	subdomain		Deletes a Theme logo. The theme will use the default Okta logo.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
subdomain	string	The domain of your organization. This can be a provided subdomain of an official okta domain (okta.com, oktapreview.com, etc) or one of your configured custom domains. (default: my-org)

SELECT examples

list_brand_themes

Lists all the themes in your brand.

> Important: Currently each org supports only one theme, therefore this contains a single object only.

SELECT
id,
_links,
backgroundImage,
emailTemplateTouchPointVariant,
endUserDashboardTouchPointVariant,
errorPageTouchPointVariant,
favicon,
loadingPageTouchPointVariant,
logo,
primaryColorContrastHex,
primaryColorHex,
secondaryColorContrastHex,
secondaryColorHex,
signInPageTouchPointVariant
FROM okta.brands.themes
WHERE subdomain = '{{ subdomain }}' -- required
;

get_brand_theme

Retrieves a theme for a brand

SELECT
id,
_links,
backgroundImage,
emailTemplateTouchPointVariant,
endUserDashboardTouchPointVariant,
errorPageTouchPointVariant,
favicon,
loadingPageTouchPointVariant,
logo,
primaryColorContrastHex,
primaryColorHex,
secondaryColorContrastHex,
secondaryColorHex,
signInPageTouchPointVariant
FROM okta.brands.themes
WHERE subdomain = '{{ subdomain }}' -- required
;

REPLACE examples

replace_brand_theme

Replaces a theme for a brand

REPLACE okta.brands.themes
SET 
data__emailTemplateTouchPointVariant = '{{ emailTemplateTouchPointVariant }}',
data__endUserDashboardTouchPointVariant = '{{ endUserDashboardTouchPointVariant }}',
data__errorPageTouchPointVariant = '{{ errorPageTouchPointVariant }}',
data__loadingPageTouchPointVariant = '{{ loadingPageTouchPointVariant }}',
data__primaryColorContrastHex = '{{ primaryColorContrastHex }}',
data__primaryColorHex = '{{ primaryColorHex }}',
data__secondaryColorContrastHex = '{{ secondaryColorContrastHex }}',
data__secondaryColorHex = '{{ secondaryColorHex }}',
data__signInPageTouchPointVariant = '{{ signInPageTouchPointVariant }}'
WHERE 
subdomain = '{{ subdomain }}' --required
AND data__primaryColorHex = '{{ primaryColorHex }}' --required
AND data__secondaryColorHex = '{{ secondaryColorHex }}' --required
AND data__signInPageTouchPointVariant = '{{ signInPageTouchPointVariant }}' --required
AND data__endUserDashboardTouchPointVariant = '{{ endUserDashboardTouchPointVariant }}' --required
AND data__errorPageTouchPointVariant = '{{ errorPageTouchPointVariant }}' --required
AND data__emailTemplateTouchPointVariant = '{{ emailTemplateTouchPointVariant }}' --required
RETURNING
id,
_links,
backgroundImage,
emailTemplateTouchPointVariant,
endUserDashboardTouchPointVariant,
errorPageTouchPointVariant,
favicon,
loadingPageTouchPointVariant,
logo,
primaryColorContrastHex,
primaryColorHex,
secondaryColorContrastHex,
secondaryColorHex,
signInPageTouchPointVariant
;

Lifecycle Methods

upload_brand_theme_background_image

Uploads and replaces the background image for the theme. The file must be in PNG, JPG, or GIF format and less than 2 MB in size.

EXEC okta.brands.themes.upload_brand_theme_background_image 
@subdomain='{{ subdomain }}' --required 
@@json=
'{
"file": "{{ file }}"
}'
;

delete_brand_theme_background_image

Deletes a theme background image

EXEC okta.brands.themes.delete_brand_theme_background_image 
@subdomain='{{ subdomain }}' --required
;

upload_brand_theme_favicon

Uploads and replaces the favicon for the theme

EXEC okta.brands.themes.upload_brand_theme_favicon 
@subdomain='{{ subdomain }}' --required 
@@json=
'{
"file": "{{ file }}"
}'
;

delete_brand_theme_favicon

Deletes a theme favicon. The theme will use the default Okta favicon.

EXEC okta.brands.themes.delete_brand_theme_favicon 
@subdomain='{{ subdomain }}' --required
;

upload_brand_theme_logo

Uploads and replaces the logo for the theme. The file must be in PNG, JPG, or GIF format and less than 100kB in size. For best results use landscape orientation, a transparent background, and a minimum size of 300px by 50px to prevent upscaling.

EXEC okta.brands.themes.upload_brand_theme_logo 
@subdomain='{{ subdomain }}' --required 
@@json=
'{
"file": "{{ file }}"
}'
;

delete_brand_theme_logo

Deletes a Theme logo. The theme will use the default Okta logo.

EXEC okta.brands.themes.delete_brand_theme_logo 
@subdomain='{{ subdomain }}' --required
;