Get the current active branding settings
Return the current active branding settings for the requested context
Query Parameters
- ctx.orgId string
- ctx.instance boolean
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs tosettings object
lightTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
darkTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
fontUrl stringurl to the font used
hideLoginNameSuffix hides the org suffix on the login form if the scope \"urn:zitadel:iam:org:domain:primary:{domainname}\" is sethides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
disableWatermark booleanboolean to disable the watermark
resourceOwnerType resource_owner_type returns if the setting is managed on the organization or on the instancePossible values: [
RESOURCE_OWNER_TYPE_UNSPECIFIED
,RESOURCE_OWNER_TYPE_INSTANCE
,RESOURCE_OWNER_TYPE_ORG
]Default value:
RESOURCE_OWNER_TYPE_UNSPECIFIED
resource_owner_type returns if the setting is managed on the organization or on the instance
{
"details": {
"sequence": "2",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"settings": {
"lightTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"darkTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"fontUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/font-180950243237405441",
"hideLoginNameSuffix": true,
"disableWatermark": true,
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs tosettings object
lightTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
darkTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
fontUrl stringurl to the font used
hideLoginNameSuffix hides the org suffix on the login form if the scope \"urn:zitadel:iam:org:domain:primary:{domainname}\" is sethides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
disableWatermark booleanboolean to disable the watermark
resourceOwnerType resource_owner_type returns if the setting is managed on the organization or on the instancePossible values: [
RESOURCE_OWNER_TYPE_UNSPECIFIED
,RESOURCE_OWNER_TYPE_INSTANCE
,RESOURCE_OWNER_TYPE_ORG
]Default value:
RESOURCE_OWNER_TYPE_UNSPECIFIED
resource_owner_type returns if the setting is managed on the organization or on the instance
{
"details": {
"sequence": "2",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"settings": {
"lightTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"darkTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"fontUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/font-180950243237405441",
"hideLoginNameSuffix": true,
"disableWatermark": true,
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
details object
sequence uint64on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
changeDate date-timeon read: the timestamp of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
resourceOwner resource_owner is the organization or instance_id an object belongs tosettings object
lightTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
darkTheme object
primaryColor hex value for primary colorhex value for primary color
backgroundColor hex value for background colorhex value for background color
warnColor hex value for warning colorhex value for warn color
fontColor hex value for font colorhex value for font color
logoUrl url where the logo is servedurl to the logo
iconUrl url where the icon is servedurl to the icon
fontUrl stringurl to the font used
hideLoginNameSuffix hides the org suffix on the login form if the scope \"urn:zitadel:iam:org:domain:primary:{domainname}\" is sethides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
disableWatermark booleanboolean to disable the watermark
resourceOwnerType resource_owner_type returns if the setting is managed on the organization or on the instancePossible values: [
RESOURCE_OWNER_TYPE_UNSPECIFIED
,RESOURCE_OWNER_TYPE_INSTANCE
,RESOURCE_OWNER_TYPE_ORG
]Default value:
RESOURCE_OWNER_TYPE_UNSPECIFIED
resource_owner_type returns if the setting is managed on the organization or on the instance
{
"details": {
"sequence": "2",
"changeDate": "2023-05-12",
"resourceOwner": "69629023906488334"
},
"settings": {
"lightTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"darkTheme": {
"primaryColor": "#5469d4",
"backgroundColor": "#FAFAFA",
"warnColor": "#CD3D56",
"fontColor": "#000000",
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817"
},
"fontUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/font-180950243237405441",
"hideLoginNameSuffix": true,
"disableWatermark": true,
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
Returned when the user does not have permission to access the resource.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Returned when the resource does not exist.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
- code int32
- message string
details object[]
Array [@type string]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}