Get Label Policy
GET/policies/label
Returns the label settings that should be used for the authenticated user. It is set either on an instance or organization level. This policy defines the branding, colors, fonts, images, etc.
Responses​
- 200
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
policy
object
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
hex value for primary color
defines if the organization's admin changed the policy
hides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
hex value for warn color
hex value for background color
hex value for font color
hex value for the primary color dark theme
hex value for background color dark theme
hex value for warning color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
Possible values: [THEME_MODE_UNSPECIFIED
, THEME_MODE_AUTO
, THEME_MODE_DARK
, THEME_MODE_LIGHT
]
Default value: THEME_MODE_UNSPECIFIED
{
"policy": {
"details": {
"sequence": "2",
"creationDate": "2024-11-15T21:46:10.508Z",
"changeDate": "2024-11-15T21:46:10.508Z",
"resourceOwner": "69629023906488334"
},
"primaryColor": "#5469d4",
"isDefault": true,
"hideLoginNameSuffix": true,
"warnColor": "#CD3D56",
"backgroundColor": "#FAFAFA",
"fontColor": "#000000",
"primaryColorDark": "#BBBAFA",
"backgroundColorDark": "#111827",
"warnColorDark": "#FF3B5B",
"fontColorDark": "#FFFFFF",
"disableWatermark": true,
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817",
"logoUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-dark-180950229376461345",
"iconUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-dark-180950243237405441",
"fontUrl": "string",
"themeMode": "THEME_MODE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
policy
object
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
hex value for primary color
defines if the organization's admin changed the policy
hides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
hex value for warn color
hex value for background color
hex value for font color
hex value for the primary color dark theme
hex value for background color dark theme
hex value for warning color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
Possible values: [THEME_MODE_UNSPECIFIED
, THEME_MODE_AUTO
, THEME_MODE_DARK
, THEME_MODE_LIGHT
]
Default value: THEME_MODE_UNSPECIFIED
{
"policy": {
"details": {
"sequence": "2",
"creationDate": "2024-11-15T21:46:10.508Z",
"changeDate": "2024-11-15T21:46:10.508Z",
"resourceOwner": "69629023906488334"
},
"primaryColor": "#5469d4",
"isDefault": true,
"hideLoginNameSuffix": true,
"warnColor": "#CD3D56",
"backgroundColor": "#FAFAFA",
"fontColor": "#000000",
"primaryColorDark": "#BBBAFA",
"backgroundColorDark": "#111827",
"warnColorDark": "#FF3B5B",
"fontColorDark": "#FFFFFF",
"disableWatermark": true,
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817",
"logoUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-dark-180950229376461345",
"iconUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-dark-180950243237405441",
"fontUrl": "string",
"themeMode": "THEME_MODE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
policy
object
details
object
on read: the sequence of the last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the first event of the object
on create: the timestamp of the event(s) added by the manipulation
on read: the timestamp of the last event reduced by the projection
on manipulation: the
hex value for primary color
defines if the organization's admin changed the policy
hides the org suffix on the login form if the scope "urn:zitadel:iam:org:domain:primary:{domainname}" is set
hex value for warn color
hex value for background color
hex value for font color
hex value for the primary color dark theme
hex value for background color dark theme
hex value for warning color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
hex value for font color dark theme
Possible values: [THEME_MODE_UNSPECIFIED
, THEME_MODE_AUTO
, THEME_MODE_DARK
, THEME_MODE_LIGHT
]
Default value: THEME_MODE_UNSPECIFIED
{
"policy": {
"details": {
"sequence": "2",
"creationDate": "2024-11-15T21:46:10.509Z",
"changeDate": "2024-11-15T21:46:10.509Z",
"resourceOwner": "69629023906488334"
},
"primaryColor": "#5469d4",
"isDefault": true,
"hideLoginNameSuffix": true,
"warnColor": "#CD3D56",
"backgroundColor": "#FAFAFA",
"fontColor": "#000000",
"primaryColorDark": "#BBBAFA",
"backgroundColorDark": "#111827",
"warnColorDark": "#FF3B5B",
"fontColorDark": "#FFFFFF",
"disableWatermark": true,
"logoUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-180950416321494657",
"iconUrl": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-180950498874178817",
"logoUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/logo-dark-180950229376461345",
"iconUrlDark": "https://acme.com/assets/v1/165617850692654601/policy/label/icon-dark-180950243237405441",
"fontUrl": "string",
"themeMode": "THEME_MODE_UNSPECIFIED"
}
}
An unexpected error response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
- Schema
- Example (from schema)
Schema
Array [
]
details
object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}