TheArchive/zitadel
1
0
Fork 0
mirror of https://github.com/zitadel/zitadel.git synced 2025-04-07 15:44:32 +00:00
Code Issues Packages Projects Releases Wiki Activity
zitadel/docs/docs/apis/proto/admin.md
Livio Amstutz 3a63fb765a
fix: cleanup some todos (#3642) 
* cleanup todo

* fix: some todos
2022-05-16 16:35:49 +02:00

89 KiB
Raw Blame History

title
zitadel/admin.proto

This document reflects the state from API 1.0 (available from 20.04.2021)

AdminService

Healthz

rpc Healthz(HealthzRequest) HealthzResponse

Indicates if ZITADEL is running. It respondes as soon as ZITADEL started

GET: /healthz

GetSupportedLanguages

rpc GetSupportedLanguages(GetSupportedLanguagesRequest) GetSupportedLanguagesResponse

Returns the default languages

GET: /languages

SetDefaultLanguage

rpc SetDefaultLanguage(SetDefaultLanguageRequest) SetDefaultLanguageResponse

Set the default language

PUT: /languages/default/{language}

GetDefaultLanguage

rpc GetDefaultLanguage(GetDefaultLanguageRequest) GetDefaultLanguageResponse

Set the default language

GET: /languages/default

ListInstanceDomains

rpc ListInstanceDomains(ListInstanceDomainsRequest) ListInstanceDomainsResponse

Returns the domains of an instance

GET: /domains

ListSecretGenerators

rpc ListSecretGenerators(ListSecretGeneratorsRequest) ListSecretGeneratorsResponse

Set the default language

POST: /secretgenerators/_search

GetSecretGenerator

rpc GetSecretGenerator(GetSecretGeneratorRequest) GetSecretGeneratorResponse

Get Secret Generator by type (e.g PasswordResetCode)

GET: /secretgenerators/{generator_type}

UpdateSecretGenerator

rpc UpdateSecretGenerator(UpdateSecretGeneratorRequest) UpdateSecretGeneratorResponse

Update secret generator configuration

PUT: /secretgenerators/{generator_type}

GetSMTPConfig

rpc GetSMTPConfig(GetSMTPConfigRequest) GetSMTPConfigResponse

Get system smtp configuration

GET: /smtp

UpdateSMTPConfig

rpc UpdateSMTPConfig(UpdateSMTPConfigRequest) UpdateSMTPConfigResponse

Update system smtp configuration

PUT: /smtp

UpdateSMTPConfigPassword

rpc UpdateSMTPConfigPassword(UpdateSMTPConfigPasswordRequest) UpdateSMTPConfigPasswordResponse

Update system smtp configuration password for host

PUT: /smtp/password

ListSMSProviders

rpc ListSMSProviders(ListSMSProvidersRequest) ListSMSProvidersResponse

list sms provider configurations

POST: /sms/_search

GetSMSProvider

rpc GetSMSProvider(GetSMSProviderRequest) GetSMSProviderResponse

Get sms provider

GET: /sms/{id}

AddSMSProviderTwilio

rpc AddSMSProviderTwilio(AddSMSProviderTwilioRequest) AddSMSProviderTwilioResponse

Add twilio sms provider

POST: /sms/twilio

UpdateSMSProviderTwilio

rpc UpdateSMSProviderTwilio(UpdateSMSProviderTwilioRequest) UpdateSMSProviderTwilioResponse

Update twilio sms provider

PUT: /sms/twilio/{id}

UpdateSMSProviderTwilioToken

rpc UpdateSMSProviderTwilioToken(UpdateSMSProviderTwilioTokenRequest) UpdateSMSProviderTwilioTokenResponse

Update twilio sms provider token

PUT: /sms/twilio/{id}/token

GetOIDCSettings

rpc GetOIDCSettings(GetOIDCSettingsRequest) GetOIDCSettingsResponse

Get OIDC settings (e.g token lifetimes, etc.)

GET: /settings/oidc

UpdateOIDCSettings

rpc UpdateOIDCSettings(UpdateOIDCSettingsRequest) UpdateOIDCSettingsResponse

Update oidc settings (e.g token lifetimes, etc)

PUT: /settings/oidc

GetFileSystemNotificationProvider

rpc GetFileSystemNotificationProvider(GetFileSystemNotificationProviderRequest) GetFileSystemNotificationProviderResponse

Get file system notification provider

GET: /notification/provider/file

GetLogNotificationProvider

rpc GetLogNotificationProvider(GetLogNotificationProviderRequest) GetLogNotificationProviderResponse

Get log notification provider

GET: /notification/provider/log

GetOrgByID

rpc GetOrgByID(GetOrgByIDRequest) GetOrgByIDResponse

Returns an organisation by id

GET: /orgs/{id}

IsOrgUnique

rpc IsOrgUnique(IsOrgUniqueRequest) IsOrgUniqueResponse

Checks whether an organisation exists by the given parameters

GET: /orgs/_is_unique

ListOrgs

rpc ListOrgs(ListOrgsRequest) ListOrgsResponse

Returns all organisations matching the request all queries need to match (AND)

POST: /orgs/_search

SetUpOrg

rpc SetUpOrg(SetUpOrgRequest) SetUpOrgResponse

Creates a new org and user and adds the user to the orgs members as ORG_OWNER

POST: /orgs/_setup

GetIDPByID

rpc GetIDPByID(GetIDPByIDRequest) GetIDPByIDResponse

Returns a identity provider configuration of the IAM instance

GET: /idps/{id}

ListIDPs

rpc ListIDPs(ListIDPsRequest) ListIDPsResponse

Returns all identity provider configurations of the IAM instance

POST: /idps/_search

AddOIDCIDP

rpc AddOIDCIDP(AddOIDCIDPRequest) AddOIDCIDPResponse

Adds a new oidc identity provider configuration the IAM instance

POST: /idps/oidc

AddJWTIDP

rpc AddJWTIDP(AddJWTIDPRequest) AddJWTIDPResponse

Adds a new jwt identity provider configuration the IAM instance

POST: /idps/jwt

UpdateIDP

rpc UpdateIDP(UpdateIDPRequest) UpdateIDPResponse

Updates the specified idp all fields are updated. If no value is provided the field will be empty afterwards.

PUT: /idps/{idp_id}

DeactivateIDP

rpc DeactivateIDP(DeactivateIDPRequest) DeactivateIDPResponse

Sets the state of the idp to IDP_STATE_INACTIVE the state MUST be IDP_STATE_ACTIVE for this call

POST: /idps/{idp_id}/_deactivate

ReactivateIDP

rpc ReactivateIDP(ReactivateIDPRequest) ReactivateIDPResponse

Sets the state of the idp to IDP_STATE_ACTIVE the state MUST be IDP_STATE_INACTIVE for this call

POST: /idps/{idp_id}/_reactivate

RemoveIDP

rpc RemoveIDP(RemoveIDPRequest) RemoveIDPResponse

RemoveIDP deletes the IDP permanetly

DELETE: /idps/{idp_id}

UpdateIDPOIDCConfig

rpc UpdateIDPOIDCConfig(UpdateIDPOIDCConfigRequest) UpdateIDPOIDCConfigResponse

Updates the oidc configuration of the specified idp all fields are updated. If no value is provided the field will be empty afterwards.

PUT: /idps/{idp_id}/oidc_config

UpdateIDPJWTConfig

rpc UpdateIDPJWTConfig(UpdateIDPJWTConfigRequest) UpdateIDPJWTConfigResponse

Updates the jwt configuration of the specified idp all fields are updated. If no value is provided the field will be empty afterwards.

PUT: /idps/{idp_id}/jwt_config

GetOrgIAMPolicy

rpc GetOrgIAMPolicy(GetOrgIAMPolicyRequest) GetOrgIAMPolicyResponse

deprecated: please use DomainPolicy instead Returns the Org IAM policy defined by the administrators of ZITADEL

GET: /policies/orgiam

UpdateOrgIAMPolicy

rpc UpdateOrgIAMPolicy(UpdateOrgIAMPolicyRequest) UpdateOrgIAMPolicyResponse

deprecated: please use DomainPolicy instead Updates the default OrgIAM policy. it impacts all organisations without a customised policy

PUT: /policies/orgiam

GetCustomOrgIAMPolicy

rpc GetCustomOrgIAMPolicy(GetCustomOrgIAMPolicyRequest) GetCustomOrgIAMPolicyResponse

deprecated: please use DomainPolicy instead Returns the customised policy or the default if not customised

GET: /orgs/{org_id}/policies/orgiam

AddCustomOrgIAMPolicy

rpc AddCustomOrgIAMPolicy(AddCustomOrgIAMPolicyRequest) AddCustomOrgIAMPolicyResponse

deprecated: please use DomainPolicy instead Defines a custom OrgIAM policy as specified

POST: /orgs/{org_id}/policies/orgiam

UpdateCustomOrgIAMPolicy

rpc UpdateCustomOrgIAMPolicy(UpdateCustomOrgIAMPolicyRequest) UpdateCustomOrgIAMPolicyResponse

deprecated: please use DomainPolicy instead Updates a custom OrgIAM policy as specified

PUT: /orgs/{org_id}/policies/orgiam

ResetCustomOrgIAMPolicyToDefault

rpc ResetCustomOrgIAMPolicyToDefault(ResetCustomOrgIAMPolicyToDefaultRequest) ResetCustomOrgIAMPolicyToDefaultResponse

deprecated: please use DomainPolicy instead Resets the org iam policy of the organisation to default ZITADEL will fallback to the default policy defined by the ZITADEL administrators

DELETE: /orgs/{org_id}/policies/orgiam

GetDomainPolicy

rpc GetDomainPolicy(GetDomainPolicyRequest) GetDomainPolicyResponse

Returns the Domain policy defined by the administrators of ZITADEL

GET: /policies/domain

UpdateDomainPolicy

rpc UpdateDomainPolicy(UpdateDomainPolicyRequest) UpdateDomainPolicyResponse

Updates the default Domain policy. it impacts all organisations without a customised policy

PUT: /policies/domain

GetCustomDomainPolicy

rpc GetCustomDomainPolicy(GetCustomDomainPolicyRequest) GetCustomDomainPolicyResponse

Returns the customised policy or the default if not customised

GET: /orgs/{org_id}/policies/domain

AddCustomDomainPolicy

rpc AddCustomDomainPolicy(AddCustomDomainPolicyRequest) AddCustomDomainPolicyResponse

Defines a custom Domain policy as specified

POST: /orgs/{org_id}/policies/domain

UpdateCustomDomainPolicy

rpc UpdateCustomDomainPolicy(UpdateCustomDomainPolicyRequest) UpdateCustomDomainPolicyResponse

Updates a custom Domain policy as specified

PUT: /orgs/{org_id}/policies/domain

ResetCustomDomainPolicyToDefault

rpc ResetCustomDomainPolicyToDefault(ResetCustomDomainPolicyToDefaultRequest) ResetCustomDomainPolicyToDefaultResponse

Resets the org iam policy of the organisation to default ZITADEL will fallback to the default policy defined by the ZITADEL administrators

DELETE: /orgs/{org_id}/policies/domain

GetLabelPolicy

rpc GetLabelPolicy(GetLabelPolicyRequest) GetLabelPolicyResponse

Returns the label policy defined by the administrators of ZITADEL

GET: /policies/label

GetPreviewLabelPolicy

rpc GetPreviewLabelPolicy(GetPreviewLabelPolicyRequest) GetPreviewLabelPolicyResponse

Returns the preview label policy defined by the administrators of ZITADEL

GET: /policies/label/_preview

UpdateLabelPolicy

rpc UpdateLabelPolicy(UpdateLabelPolicyRequest) UpdateLabelPolicyResponse

Updates the default label policy of ZITADEL it impacts all organisations without a customised policy

PUT: /policies/label

ActivateLabelPolicy

rpc ActivateLabelPolicy(ActivateLabelPolicyRequest) ActivateLabelPolicyResponse

Activates all changes of the label policy

POST: /policies/label/_activate

rpc RemoveLabelPolicyLogo(RemoveLabelPolicyLogoRequest) RemoveLabelPolicyLogoResponse

Removes the logo of the label policy

DELETE: /policies/label/logo

RemoveLabelPolicyLogoDark

rpc RemoveLabelPolicyLogoDark(RemoveLabelPolicyLogoDarkRequest) RemoveLabelPolicyLogoDarkResponse

Removes the logo dark of the label policy

DELETE: /policies/label/logo_dark

RemoveLabelPolicyIcon

rpc RemoveLabelPolicyIcon(RemoveLabelPolicyIconRequest) RemoveLabelPolicyIconResponse

Removes the icon of the label policy

DELETE: /policies/label/icon

RemoveLabelPolicyIconDark

rpc RemoveLabelPolicyIconDark(RemoveLabelPolicyIconDarkRequest) RemoveLabelPolicyIconDarkResponse

Removes the logo dark of the label policy

DELETE: /policies/label/icon_dark

RemoveLabelPolicyFont

rpc RemoveLabelPolicyFont(RemoveLabelPolicyFontRequest) RemoveLabelPolicyFontResponse

Removes the font of the label policy

DELETE: /policies/label/font

GetLoginPolicy

rpc GetLoginPolicy(GetLoginPolicyRequest) GetLoginPolicyResponse

Returns the login policy defined by the administrators of ZITADEL

GET: /policies/login

UpdateLoginPolicy

rpc UpdateLoginPolicy(UpdateLoginPolicyRequest) UpdateLoginPolicyResponse

Updates the default login policy of ZITADEL it impacts all organisations without a customised policy

PUT: /policies/login

ListLoginPolicyIDPs

rpc ListLoginPolicyIDPs(ListLoginPolicyIDPsRequest) ListLoginPolicyIDPsResponse

Returns the idps linked to the default login policy, defined by the administrators of ZITADEL

POST: /policies/login/idps/_search

AddIDPToLoginPolicy

rpc AddIDPToLoginPolicy(AddIDPToLoginPolicyRequest) AddIDPToLoginPolicyResponse

Adds the povided idp to the default login policy. It impacts all organisations without a customised policy

POST: /policies/login/idps

RemoveIDPFromLoginPolicy

rpc RemoveIDPFromLoginPolicy(RemoveIDPFromLoginPolicyRequest) RemoveIDPFromLoginPolicyResponse

Removes the povided idp from the default login policy. It impacts all organisations without a customised policy

DELETE: /policies/login/idps/{idp_id}

ListLoginPolicySecondFactors

rpc ListLoginPolicySecondFactors(ListLoginPolicySecondFactorsRequest) ListLoginPolicySecondFactorsResponse

Returns the available second factors defined by the administrators of ZITADEL

POST: /policies/login/second_factors/_search

AddSecondFactorToLoginPolicy

rpc AddSecondFactorToLoginPolicy(AddSecondFactorToLoginPolicyRequest) AddSecondFactorToLoginPolicyResponse

Adds a second factor to the default login policy. It impacts all organisations without a customised policy

POST: /policies/login/second_factors

RemoveSecondFactorFromLoginPolicy

rpc RemoveSecondFactorFromLoginPolicy(RemoveSecondFactorFromLoginPolicyRequest) RemoveSecondFactorFromLoginPolicyResponse

Removes a second factor from the default login policy. It impacts all organisations without a customised policy

DELETE: /policies/login/second_factors/{type}

ListLoginPolicyMultiFactors

rpc ListLoginPolicyMultiFactors(ListLoginPolicyMultiFactorsRequest) ListLoginPolicyMultiFactorsResponse

Returns the available multi factors defined by the administrators of ZITADEL

POST: /policies/login/multi_factors/_search

AddMultiFactorToLoginPolicy

rpc AddMultiFactorToLoginPolicy(AddMultiFactorToLoginPolicyRequest) AddMultiFactorToLoginPolicyResponse

Adds a multi factor to the default login policy. It impacts all organisations without a customised policy

POST: /policies/login/multi_factors

RemoveMultiFactorFromLoginPolicy

rpc RemoveMultiFactorFromLoginPolicy(RemoveMultiFactorFromLoginPolicyRequest) RemoveMultiFactorFromLoginPolicyResponse

Removes a multi factor from the default login policy. It impacts all organisations without a customised policy

DELETE: /policies/login/multi_factors/{type}

GetPasswordComplexityPolicy

rpc GetPasswordComplexityPolicy(GetPasswordComplexityPolicyRequest) GetPasswordComplexityPolicyResponse

Returns the password complexity policy defined by the administrators of ZITADEL

GET: /policies/password/complexity

UpdatePasswordComplexityPolicy

rpc UpdatePasswordComplexityPolicy(UpdatePasswordComplexityPolicyRequest) UpdatePasswordComplexityPolicyResponse

Updates the default password complexity policy of ZITADEL it impacts all organisations without a customised policy

PUT: /policies/password/complexity

GetPasswordAgePolicy

rpc GetPasswordAgePolicy(GetPasswordAgePolicyRequest) GetPasswordAgePolicyResponse

Returns the password age policy defined by the administrators of ZITADEL

GET: /policies/password/age

UpdatePasswordAgePolicy

rpc UpdatePasswordAgePolicy(UpdatePasswordAgePolicyRequest) UpdatePasswordAgePolicyResponse

Updates the default password age policy of ZITADEL it impacts all organisations without a customised policy

PUT: /policies/password/age

GetLockoutPolicy

rpc GetLockoutPolicy(GetLockoutPolicyRequest) GetLockoutPolicyResponse

Returns the lockout policy defined by the administrators of ZITADEL

GET: /policies/lockout

UpdateLockoutPolicy

rpc UpdateLockoutPolicy(UpdateLockoutPolicyRequest) UpdateLockoutPolicyResponse

Updates the default lockout policy of ZITADEL it impacts all organisations without a customised policy

PUT: /policies/password/lockout

GetPrivacyPolicy

rpc GetPrivacyPolicy(GetPrivacyPolicyRequest) GetPrivacyPolicyResponse

Returns the privacy policy defined by the administrators of ZITADEL

GET: /policies/privacy

UpdatePrivacyPolicy

rpc UpdatePrivacyPolicy(UpdatePrivacyPolicyRequest) UpdatePrivacyPolicyResponse

Updates the default privacy policy of ZITADEL it impacts all organisations without a customised policy Variable {{.Lang}} can be set to have different links based on the language

PUT: /policies/privacy

GetDefaultInitMessageText

rpc GetDefaultInitMessageText(GetDefaultInitMessageTextRequest) GetDefaultInitMessageTextResponse

Returns the default text for initial message (translation file)

GET: /text/default/message/init/{language}

GetCustomInitMessageText

rpc GetCustomInitMessageText(GetCustomInitMessageTextRequest) GetCustomInitMessageTextResponse

Returns the custom text for initial message (overwritten in eventstore)

GET: /text/message/init/{language}

SetDefaultInitMessageText

rpc SetDefaultInitMessageText(SetDefaultInitMessageTextRequest) SetDefaultInitMessageTextResponse

Sets the default custom text for initial message it impacts all organisations without customized initial message text The Following Variables can be used: {{.Code}} {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/init/{language}

ResetCustomInitMessageTextToDefault

rpc ResetCustomInitMessageTextToDefault(ResetCustomInitMessageTextToDefaultRequest) ResetCustomInitMessageTextToDefaultResponse

Removes the custom init message text of the system The default text from the translation file will trigger after

DELETE: /text/message/init/{language}

GetDefaultPasswordResetMessageText

rpc GetDefaultPasswordResetMessageText(GetDefaultPasswordResetMessageTextRequest) GetDefaultPasswordResetMessageTextResponse

Returns the default text for password reset message (translation file)

GET: /text/deafult/message/passwordreset/{language}

GetCustomPasswordResetMessageText

rpc GetCustomPasswordResetMessageText(GetCustomPasswordResetMessageTextRequest) GetCustomPasswordResetMessageTextResponse

Returns the custom text for password reset message (overwritten in eventstore)

GET: /text/message/passwordreset/{language}

SetDefaultPasswordResetMessageText

rpc SetDefaultPasswordResetMessageText(SetDefaultPasswordResetMessageTextRequest) SetDefaultPasswordResetMessageTextResponse

Sets the default custom text for password reset message it impacts all organisations without customized password reset message text The Following Variables can be used: {{.Code}} {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/passwordreset/{language}

ResetCustomPasswordResetMessageTextToDefault

rpc ResetCustomPasswordResetMessageTextToDefault(ResetCustomPasswordResetMessageTextToDefaultRequest) ResetCustomPasswordResetMessageTextToDefaultResponse

Removes the custom password reset message text of the system The default text from the translation file will trigger after

DELETE: /text/message/verifyemail/{language}

GetDefaultVerifyEmailMessageText

rpc GetDefaultVerifyEmailMessageText(GetDefaultVerifyEmailMessageTextRequest) GetDefaultVerifyEmailMessageTextResponse

Returns the default text for verify email message (translation files)

GET: /text/default/message/verifyemail/{language}

GetCustomVerifyEmailMessageText

rpc GetCustomVerifyEmailMessageText(GetCustomVerifyEmailMessageTextRequest) GetCustomVerifyEmailMessageTextResponse

Returns the custom text for verify email message (overwritten in eventstore)

GET: /text/message/verifyemail/{language}

SetDefaultVerifyEmailMessageText

rpc SetDefaultVerifyEmailMessageText(SetDefaultVerifyEmailMessageTextRequest) SetDefaultVerifyEmailMessageTextResponse

Sets the default custom text for verify email message it impacts all organisations without customized verify email message text The Following Variables can be used: {{.Code}} {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/verifyemail/{language}

ResetCustomVerifyEmailMessageTextToDefault

rpc ResetCustomVerifyEmailMessageTextToDefault(ResetCustomVerifyEmailMessageTextToDefaultRequest) ResetCustomVerifyEmailMessageTextToDefaultResponse

Removes the custom verify email message text of the system The default text from the translation file will trigger after

DELETE: /text/message/verifyemail/{language}

GetDefaultVerifyPhoneMessageText

rpc GetDefaultVerifyPhoneMessageText(GetDefaultVerifyPhoneMessageTextRequest) GetDefaultVerifyPhoneMessageTextResponse

Returns the default text for verify phone message (translation file)

GET: /text/default/message/verifyphone/{language}

GetCustomVerifyPhoneMessageText

rpc GetCustomVerifyPhoneMessageText(GetCustomVerifyPhoneMessageTextRequest) GetCustomVerifyPhoneMessageTextResponse

Returns the custom text for verify phone message

GET: /text/message/verifyphone/{language}

SetDefaultVerifyPhoneMessageText

rpc SetDefaultVerifyPhoneMessageText(SetDefaultVerifyPhoneMessageTextRequest) SetDefaultVerifyPhoneMessageTextResponse

Sets the default custom text for verify phone message it impacts all organisations without customized verify phone message text The Following Variables can be used: {{.Code}} {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/verifyphone/{language}

ResetCustomVerifyPhoneMessageTextToDefault

rpc ResetCustomVerifyPhoneMessageTextToDefault(ResetCustomVerifyPhoneMessageTextToDefaultRequest) ResetCustomVerifyPhoneMessageTextToDefaultResponse

Removes the custom verify phone text of the system The default text from the translation file will trigger after

DELETE: /text/message/verifyphone/{language}

GetDefaultDomainClaimedMessageText

rpc GetDefaultDomainClaimedMessageText(GetDefaultDomainClaimedMessageTextRequest) GetDefaultDomainClaimedMessageTextResponse

Returns the default text for domain claimed message (translation file)

GET: /text/default/message/domainclaimed/{language}

GetCustomDomainClaimedMessageText

rpc GetCustomDomainClaimedMessageText(GetCustomDomainClaimedMessageTextRequest) GetCustomDomainClaimedMessageTextResponse

Returns the custom text for domain claimed message (overwritten in eventstore)

GET: /text/message/domainclaimed/{language}

SetDefaultDomainClaimedMessageText

rpc SetDefaultDomainClaimedMessageText(SetDefaultDomainClaimedMessageTextRequest) SetDefaultDomainClaimedMessageTextResponse

Sets the default custom text for domain claimed phone message it impacts all organisations without customized domain claimed message text The Following Variables can be used: {{.Domain}} {{.TempUsername}} {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/domainclaimed/{language}

ResetCustomDomainClaimedMessageTextToDefault

rpc ResetCustomDomainClaimedMessageTextToDefault(ResetCustomDomainClaimedMessageTextToDefaultRequest) ResetCustomDomainClaimedMessageTextToDefaultResponse

Removes the custom domain claimed message text of the system The default text from the translation file will trigger after

DELETE: /text/message/domainclaimed/{language}

GetDefaultPasswordlessRegistrationMessageText

rpc GetDefaultPasswordlessRegistrationMessageText(GetDefaultPasswordlessRegistrationMessageTextRequest) GetDefaultPasswordlessRegistrationMessageTextResponse

Returns the default text for passwordless registration message (translation file)

GET: /text/default/message/passwordless_registration/{language}

GetCustomPasswordlessRegistrationMessageText

rpc GetCustomPasswordlessRegistrationMessageText(GetCustomPasswordlessRegistrationMessageTextRequest) GetCustomPasswordlessRegistrationMessageTextResponse

Returns the custom text for passwordless registration message (overwritten in eventstore)

GET: /text/message/passwordless_registration/{language}

SetDefaultPasswordlessRegistrationMessageText

rpc SetDefaultPasswordlessRegistrationMessageText(SetDefaultPasswordlessRegistrationMessageTextRequest) SetDefaultPasswordlessRegistrationMessageTextResponse

Sets the default custom text for passwordless registration message it impacts all organisations without customized passwordless registration message text The Following Variables can be used: {{.UserName}} {{.FirstName}} {{.LastName}} {{.NickName}} {{.DisplayName}} {{.LastEmail}} {{.VerifiedEmail}} {{.LastPhone}} {{.VerifiedPhone}} {{.PreferredLoginName}} {{.LoginNames}} {{.ChangeDate}}

PUT: /text/message/passwordless_registration/{language}

ResetCustomPasswordlessRegistrationMessageTextToDefault

rpc ResetCustomPasswordlessRegistrationMessageTextToDefault(ResetCustomPasswordlessRegistrationMessageTextToDefaultRequest) ResetCustomPasswordlessRegistrationMessageTextToDefaultResponse

Removes the custom passwordless link message text of the system The default text from the translation file will trigger after

DELETE: /text/message/passwordless_registration/{language}

GetDefaultLoginTexts

rpc GetDefaultLoginTexts(GetDefaultLoginTextsRequest) GetDefaultLoginTextsResponse

Returns the default custom texts for login ui (translation file)

GET: /text/default/login/{language}

GetCustomLoginTexts

rpc GetCustomLoginTexts(GetCustomLoginTextsRequest) GetCustomLoginTextsResponse

Returns the custom texts for login ui

GET: /text/login/{language}

SetCustomLoginText

rpc SetCustomLoginText(SetCustomLoginTextsRequest) SetCustomLoginTextsResponse

Sets the custom text for login ui it impacts all organisations without customized login ui texts

PUT: /text/login/{language}

ResetCustomLoginTextToDefault

rpc ResetCustomLoginTextToDefault(ResetCustomLoginTextsToDefaultRequest) ResetCustomLoginTextsToDefaultResponse

Removes the custom texts for login ui it impacts all organisations without customized login ui texts The default text form translation file will trigger after

DELETE: /text/login/{language}

ListIAMMemberRoles

rpc ListIAMMemberRoles(ListIAMMemberRolesRequest) ListIAMMemberRolesResponse

Returns the IAM roles visible for the requested user

POST: /members/roles/_search

ListIAMMembers

rpc ListIAMMembers(ListIAMMembersRequest) ListIAMMembersResponse

Returns all members matching the request all queries need to match (ANDed)

POST: /members/_search

AddIAMMember

rpc AddIAMMember(AddIAMMemberRequest) AddIAMMemberResponse

Adds a user to the membership list of ZITADEL with the given roles undefined roles will be dropped

POST: /members

UpdateIAMMember

rpc UpdateIAMMember(UpdateIAMMemberRequest) UpdateIAMMemberResponse

Sets the given roles on a member. The member has only roles provided by this call

PUT: /members/{user_id}

RemoveIAMMember

rpc RemoveIAMMember(RemoveIAMMemberRequest) RemoveIAMMemberResponse

Removes the user from the membership list of ZITADEL

DELETE: /members/{user_id}

ListViews

rpc ListViews(ListViewsRequest) ListViewsResponse

Returns all stored read models of ZITADEL views are used for search optimisation and optimise request latencies they represent the delta of the event happend on the objects

POST: /views/_search

ListFailedEvents

rpc ListFailedEvents(ListFailedEventsRequest) ListFailedEventsResponse

Returns event descriptions which cannot be processed. It's possible that some events need some retries. For example if the SMTP-API wasn't able to send an email at the first time

POST: /failedevents/_search

RemoveFailedEvent

rpc RemoveFailedEvent(RemoveFailedEventRequest) RemoveFailedEventResponse

Deletes the event from failed events view. the event is not removed from the change stream This call is usefull if the system was able to process the event later. e.g. if the second try of sending an email was successful. the first try produced a failed event. You can find out if it worked on the failure_count

DELETE: /failedevents/{database}/{view_name}/{failed_sequence}

Messages

ActivateLabelPolicyRequest

This is an empty request

ActivateLabelPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddCustomDomainPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200
user_login_must_be_domain bool the username has to end with the domain of it's organisation (uniqueness is organisation based)
validate_org_domains bool -
smtp_sender_address_matches_instance_domain bool -

AddCustomDomainPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddCustomOrgIAMPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200
user_login_must_be_domain bool the username has to end with the domain of it's organisation (uniqueness is organisation based)

AddCustomOrgIAMPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddIAMMemberRequest

Field Type Description Validation
user_id string - string.min_len: 1
string.max_len: 200
roles repeated string if no roles provided the user won't have any rights

AddIAMMemberResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddIDPToLoginPolicyRequest

Field Type Description Validation
idp_id string Id of the predefined idp configuration string.min_len: 1
string.max_len: 200

AddIDPToLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddJWTIDPRequest

Field Type Description Validation
name string - string.min_len: 1
string.max_len: 200
styling_type zitadel.idp.v1.IDPStylingType - enum.defined_only: true
jwt_endpoint string - string.min_len: 1
string.max_len: 200
issuer string - string.min_len: 1
string.max_len: 200
keys_endpoint string - string.min_len: 1
string.max_len: 200
header_name string - string.min_len: 1
string.max_len: 200
auto_register bool -

AddJWTIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -
idp_id string -

AddMultiFactorToLoginPolicyRequest

Field Type Description Validation
type zitadel.policy.v1.MultiFactorType - enum.defined_only: true
enum.not_in: [0]

AddMultiFactorToLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

AddOIDCIDPRequest

Field Type Description Validation
name string - string.min_len: 1
string.max_len: 200
styling_type zitadel.idp.v1.IDPStylingType - enum.defined_only: true
client_id string - string.min_len: 1
string.max_len: 200
client_secret string - string.min_len: 1
string.max_len: 200
issuer string - string.min_len: 1
string.max_len: 200
scopes repeated string -
display_name_mapping zitadel.idp.v1.OIDCMappingField - enum.defined_only: true
username_mapping zitadel.idp.v1.OIDCMappingField - enum.defined_only: true
auto_register bool -

AddOIDCIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -
idp_id string -

AddSMSProviderTwilioRequest

Field Type Description Validation
sid string - string.min_len: 1
string.max_len: 200
token string - string.min_len: 1
string.max_len: 200
sender_number string - string.min_len: 1
string.max_len: 200

AddSMSProviderTwilioResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -
id string -

AddSecondFactorToLoginPolicyRequest

Field Type Description Validation
type zitadel.policy.v1.SecondFactorType - enum.defined_only: true
enum.not_in: [0]

AddSecondFactorToLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

DeactivateIDPRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200

DeactivateIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

FailedEvent

Field Type Description Validation
database string -
view_name string -
failed_sequence uint64 -
failure_count uint64 -
error_message string -

GetCustomDomainClaimedMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomDomainClaimedMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetCustomDomainPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200

GetCustomDomainPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.DomainPolicy -
is_default bool deprecated: is_default is also defined in zitadel.policy.v1.DomainPolicy

GetCustomInitMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomInitMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetCustomLoginTextsRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomLoginTextsResponse

Field Type Description Validation
custom_text zitadel.text.v1.LoginCustomText -

GetCustomOrgIAMPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200

GetCustomOrgIAMPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.OrgIAMPolicy -
is_default bool deprecated: is_default is also defined in zitadel.policy.v1.OrgIAMPolicy

GetCustomPasswordResetMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomPasswordResetMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetCustomPasswordlessRegistrationMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomPasswordlessRegistrationMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetCustomVerifyEmailMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomVerifyEmailMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetCustomVerifyPhoneMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetCustomVerifyPhoneMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultDomainClaimedMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultDomainClaimedMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultInitMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultInitMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultLanguageRequest

This is an empty request

GetDefaultLanguageResponse

Field Type Description Validation
language string -

GetDefaultLoginTextsRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultLoginTextsResponse

Field Type Description Validation
custom_text zitadel.text.v1.LoginCustomText -

GetDefaultPasswordResetMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultPasswordResetMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultPasswordlessRegistrationMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultPasswordlessRegistrationMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultVerifyEmailMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultVerifyEmailMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDefaultVerifyPhoneMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

GetDefaultVerifyPhoneMessageTextResponse

Field Type Description Validation
custom_text zitadel.text.v1.MessageCustomText -

GetDomainPolicyRequest

GetDomainPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.DomainPolicy -

GetFileSystemNotificationProviderRequest

This is an empty request

GetFileSystemNotificationProviderResponse

Field Type Description Validation
provider zitadel.settings.v1.DebugNotificationProvider -

GetIDPByIDRequest

Field Type Description Validation
id string - string.min_len: 1
string.max_len: 200

GetIDPByIDResponse

Field Type Description Validation
idp zitadel.idp.v1.IDP -

GetLabelPolicyRequest

This is an empty request

GetLabelPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.LabelPolicy -

GetLockoutPolicyRequest

This is an empty request

GetLockoutPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.LockoutPolicy -

GetLogNotificationProviderRequest

This is an empty request

GetLogNotificationProviderResponse

Field Type Description Validation
provider zitadel.settings.v1.DebugNotificationProvider -

GetLoginPolicyRequest

This is an empty request

GetLoginPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.LoginPolicy -

GetOIDCSettingsRequest

This is an empty request

GetOIDCSettingsResponse

Field Type Description Validation
settings zitadel.settings.v1.OIDCSettings -

GetOrgByIDRequest

Field Type Description Validation
id string - string.min_len: 1
string.max_len: 200

GetOrgByIDResponse

Field Type Description Validation
org zitadel.org.v1.Org -

GetOrgIAMPolicyRequest

GetOrgIAMPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.OrgIAMPolicy -

GetPasswordAgePolicyRequest

This is an empty request

GetPasswordAgePolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.PasswordAgePolicy -

GetPasswordComplexityPolicyRequest

GetPasswordComplexityPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.PasswordComplexityPolicy -

GetPreviewLabelPolicyRequest

This is an empty request

GetPreviewLabelPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.LabelPolicy -

GetPrivacyPolicyRequest

This is an empty request

GetPrivacyPolicyResponse

Field Type Description Validation
policy zitadel.policy.v1.PrivacyPolicy -

GetSMSProviderRequest

Field Type Description Validation
id string - string.min_len: 1
string.max_len: 100

GetSMSProviderResponse

Field Type Description Validation
config zitadel.settings.v1.SMSProvider -

GetSMTPConfigRequest

This is an empty request

GetSMTPConfigResponse

Field Type Description Validation
smtp_config zitadel.settings.v1.SMTPConfig -

GetSecretGeneratorRequest

Field Type Description Validation
generator_type zitadel.settings.v1.SecretGeneratorType - enum.defined_only: true
enum.not_in: [0]

GetSecretGeneratorResponse

Field Type Description Validation
secret_generator zitadel.settings.v1.SecretGenerator -

GetSupportedLanguagesRequest

This is an empty request

GetSupportedLanguagesResponse

Field Type Description Validation
languages repeated string -

HealthzRequest

This is an empty request

HealthzResponse

This is an empty response

IDPQuery

Field Type Description Validation
oneof query.idp_id_query zitadel.idp.v1.IDPIDQuery -
oneof query.idp_name_query zitadel.idp.v1.IDPNameQuery -

IsOrgUniqueRequest

if name or domain is already in use, org is not unique at least one argument has to be provided

Field Type Description Validation
name string - string.max_len: 200
domain string - string.max_len: 200

IsOrgUniqueResponse

Field Type Description Validation
is_unique bool -

ListFailedEventsRequest

This is an empty request

ListFailedEventsResponse

Field Type Description Validation
result repeated FailedEvent TODO: list details

ListIAMMemberRolesRequest

This is an empty request

ListIAMMemberRolesResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
roles repeated string -

ListIAMMembersRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering
queries repeated zitadel.member.v1.SearchQuery criterias the client is looking for

ListIAMMembersResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.member.v1.Member -

ListIDPsRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering
sorting_column zitadel.idp.v1.IDPFieldName the field the result is sorted
queries repeated IDPQuery criterias the client is looking for

ListIDPsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
sorting_column zitadel.idp.v1.IDPFieldName -
result repeated zitadel.idp.v1.IDP -

ListInstanceDomainsRequest

Field Type Description Validation
query zitadel.v1.ListQuery -
sorting_column zitadel.instance.v1.DomainFieldName the field the result is sorted
queries repeated zitadel.instance.v1.DomainSearchQuery criterias the client is looking for

ListInstanceDomainsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
sorting_column zitadel.instance.v1.DomainFieldName -
result repeated zitadel.instance.v1.Domain -

ListLoginPolicyIDPsRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering

ListLoginPolicyIDPsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.idp.v1.IDPLoginPolicyLink -

ListLoginPolicyMultiFactorsRequest

This is an empty request

ListLoginPolicyMultiFactorsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.policy.v1.MultiFactorType -

ListLoginPolicySecondFactorsRequest

This is an empty request

ListLoginPolicySecondFactorsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.policy.v1.SecondFactorType -

ListOrgsRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering
sorting_column zitadel.org.v1.OrgFieldName the field the result is sorted
queries repeated zitadel.org.v1.OrgQuery criterias the client is looking for

ListOrgsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
sorting_column zitadel.org.v1.OrgFieldName -
result repeated zitadel.org.v1.Org -

ListSMSProvidersRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering

ListSMSProvidersResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.settings.v1.SMSProvider -

ListSecretGeneratorsRequest

Field Type Description Validation
query zitadel.v1.ListQuery list limitations and ordering
queries repeated zitadel.settings.v1.SecretGeneratorQuery criterias the client is looking for

ListSecretGeneratorsResponse

Field Type Description Validation
details zitadel.v1.ListDetails -
result repeated zitadel.settings.v1.SecretGenerator -

ListViewsRequest

This is an empty request

ListViewsResponse

Field Type Description Validation
result repeated View TODO: list details

ReactivateIDPRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200

ReactivateIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveFailedEventRequest

Field Type Description Validation
database string - string.min_len: 1
string.max_len: 200
view_name string - string.min_len: 1
string.max_len: 200
failed_sequence uint64 -

RemoveFailedEventResponse

This is an empty response

RemoveIAMMemberRequest

Field Type Description Validation
user_id string - string.min_len: 1
string.max_len: 200

RemoveIAMMemberResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveIDPFromLoginPolicyRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200

RemoveIDPFromLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveIDPRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200

RemoveIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveLabelPolicyFontRequest

This is an empty request

RemoveLabelPolicyFontResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveLabelPolicyIconDarkRequest

This is an empty request

RemoveLabelPolicyIconDarkResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveLabelPolicyIconRequest

This is an empty request

RemoveLabelPolicyIconResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveLabelPolicyLogoDarkRequest

This is an empty request

RemoveLabelPolicyLogoDarkResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveLabelPolicyLogoRequest

This is an empty request

RemoveLabelPolicyLogoResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveMultiFactorFromLoginPolicyRequest

Field Type Description Validation
type zitadel.policy.v1.MultiFactorType - enum.defined_only: true
enum.not_in: [0]

RemoveMultiFactorFromLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

RemoveSecondFactorFromLoginPolicyRequest

Field Type Description Validation
type zitadel.policy.v1.SecondFactorType - enum.defined_only: true
enum.not_in: [0]

RemoveSecondFactorFromLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomDomainClaimedMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomDomainClaimedMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomDomainPolicyToDefaultRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200

ResetCustomDomainPolicyToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomInitMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomInitMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomLoginTextsToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomLoginTextsToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomOrgIAMPolicyToDefaultRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200

ResetCustomOrgIAMPolicyToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomPasswordResetMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomPasswordResetMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomPasswordlessRegistrationMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomPasswordlessRegistrationMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomVerifyEmailMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomVerifyEmailMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

ResetCustomVerifyPhoneMessageTextToDefaultRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200

ResetCustomVerifyPhoneMessageTextToDefaultResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetCustomLoginTextsRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
select_account_text zitadel.text.v1.SelectAccountScreenText -
login_text zitadel.text.v1.LoginScreenText -
password_text zitadel.text.v1.PasswordScreenText -
username_change_text zitadel.text.v1.UsernameChangeScreenText -
username_change_done_text zitadel.text.v1.UsernameChangeDoneScreenText -
init_password_text zitadel.text.v1.InitPasswordScreenText -
init_password_done_text zitadel.text.v1.InitPasswordDoneScreenText -
email_verification_text zitadel.text.v1.EmailVerificationScreenText -
email_verification_done_text zitadel.text.v1.EmailVerificationDoneScreenText -
initialize_user_text zitadel.text.v1.InitializeUserScreenText -
initialize_done_text zitadel.text.v1.InitializeUserDoneScreenText -
init_mfa_prompt_text zitadel.text.v1.InitMFAPromptScreenText -
init_mfa_otp_text zitadel.text.v1.InitMFAOTPScreenText -
init_mfa_u2f_text zitadel.text.v1.InitMFAU2FScreenText -
init_mfa_done_text zitadel.text.v1.InitMFADoneScreenText -
mfa_providers_text zitadel.text.v1.MFAProvidersText -
verify_mfa_otp_text zitadel.text.v1.VerifyMFAOTPScreenText -
verify_mfa_u2f_text zitadel.text.v1.VerifyMFAU2FScreenText -
passwordless_text zitadel.text.v1.PasswordlessScreenText -
password_change_text zitadel.text.v1.PasswordChangeScreenText -
password_change_done_text zitadel.text.v1.PasswordChangeDoneScreenText -
password_reset_done_text zitadel.text.v1.PasswordResetDoneScreenText -
registration_option_text zitadel.text.v1.RegistrationOptionScreenText -
registration_user_text zitadel.text.v1.RegistrationUserScreenText -
registration_org_text zitadel.text.v1.RegistrationOrgScreenText -
linking_user_done_text zitadel.text.v1.LinkingUserDoneScreenText -
external_user_not_found_text zitadel.text.v1.ExternalUserNotFoundScreenText -
success_login_text zitadel.text.v1.SuccessLoginScreenText -
logout_text zitadel.text.v1.LogoutDoneScreenText -
footer_text zitadel.text.v1.FooterText -
passwordless_prompt_text zitadel.text.v1.PasswordlessPromptScreenText -
passwordless_registration_text zitadel.text.v1.PasswordlessRegistrationScreenText -
passwordless_registration_done_text zitadel.text.v1.PasswordlessRegistrationDoneScreenText -
external_registration_user_overview_text zitadel.text.v1.ExternalRegistrationUserOverviewScreenText -

SetCustomLoginTextsResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultDomainClaimedMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 800
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultDomainClaimedMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultInitMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 1000
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultInitMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultLanguageRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 10

SetDefaultLanguageResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultPasswordResetMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 800
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultPasswordResetMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultPasswordlessRegistrationMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 800
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultPasswordlessRegistrationMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultVerifyEmailMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 800
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultVerifyEmailMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetDefaultVerifyPhoneMessageTextRequest

Field Type Description Validation
language string - string.min_len: 1
string.max_len: 200
title string - string.max_len: 200
pre_header string - string.max_len: 200
subject string - string.max_len: 200
greeting string - string.max_len: 200
text string - string.max_len: 800
button_text string - string.max_len: 200
footer_text string - string.max_len: 200

SetDefaultVerifyPhoneMessageTextResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

SetUpOrgRequest

Field Type Description Validation
org SetUpOrgRequest.Org - message.required: true
oneof user.human SetUpOrgRequest.Human oneof field for the user managing the organisation

SetUpOrgRequest.Human

Field Type Description Validation
user_name string - string.min_len: 1
string.max_len: 200
profile SetUpOrgRequest.Human.Profile - message.required: true
email SetUpOrgRequest.Human.Email - message.required: true
phone SetUpOrgRequest.Human.Phone -
password string -

SetUpOrgRequest.Human.Email

Field Type Description Validation
email string - string.email: true
is_email_verified bool -

SetUpOrgRequest.Human.Phone

Field Type Description Validation
phone string has to be a global number string.min_len: 1
string.max_len: 50
string.prefix: +
is_phone_verified bool -

SetUpOrgRequest.Human.Profile

Field Type Description Validation
first_name string - string.min_len: 1
string.max_len: 200
last_name string - string.min_len: 1
string.max_len: 200
nick_name string - string.max_len: 200
display_name string - string.max_len: 200
preferred_language string - string.max_len: 10
gender zitadel.user.v1.Gender -

SetUpOrgRequest.Org

Field Type Description Validation
name string - string.min_len: 1
string.max_len: 200
domain string - string.max_len: 200

SetUpOrgResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -
org_id string -
user_id string -

UpdateCustomDomainPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200
user_login_must_be_domain bool -
validate_org_domains bool -
smtp_sender_address_matches_instance_domain bool -

UpdateCustomDomainPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateCustomOrgIAMPolicyRequest

Field Type Description Validation
org_id string - string.min_len: 1
string.max_len: 200
user_login_must_be_domain bool -

UpdateCustomOrgIAMPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateDomainPolicyRequest

Field Type Description Validation
user_login_must_be_domain bool -
validate_org_domains bool -
smtp_sender_address_matches_instance_domain bool -

UpdateDomainPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateIAMMemberRequest

Field Type Description Validation
user_id string - string.min_len: 1
string.max_len: 200
roles repeated string if no roles provided the user won't have any rights

UpdateIAMMemberResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateIDPJWTConfigRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200
jwt_endpoint string - string.min_len: 1
string.max_len: 200
issuer string - string.min_len: 1
string.max_len: 200
keys_endpoint string - string.min_len: 1
string.max_len: 200
header_name string - string.min_len: 1
string.max_len: 200

UpdateIDPJWTConfigResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateIDPOIDCConfigRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200
issuer string - string.min_len: 1
string.max_len: 200
client_id string - string.min_len: 1
string.max_len: 200
client_secret string - string.max_len: 200
scopes repeated string -
display_name_mapping zitadel.idp.v1.OIDCMappingField - enum.defined_only: true
username_mapping zitadel.idp.v1.OIDCMappingField - enum.defined_only: true

UpdateIDPOIDCConfigResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateIDPRequest

Field Type Description Validation
idp_id string - string.min_len: 1
string.max_len: 200
name string - string.min_len: 1
string.max_len: 200
styling_type zitadel.idp.v1.IDPStylingType - enum.defined_only: true
auto_register bool -

UpdateIDPResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateLabelPolicyRequest

Field Type Description Validation
primary_color string - string.max_len: 50
hide_login_name_suffix bool -
warn_color string - string.max_len: 50
background_color string - string.max_len: 50
font_color string - string.max_len: 50
primary_color_dark string - string.max_len: 50
background_color_dark string - string.max_len: 50
warn_color_dark string - string.max_len: 50
font_color_dark string - string.max_len: 50
disable_watermark bool -

UpdateLabelPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateLockoutPolicyRequest

Field Type Description Validation
max_password_attempts uint32 failed attempts until a user gets locked

UpdateLockoutPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateLoginPolicyRequest

Field Type Description Validation
allow_username_password bool -
allow_register bool -
allow_external_idp bool -
force_mfa bool -
passwordless_type zitadel.policy.v1.PasswordlessType - enum.defined_only: true
hide_password_reset bool -
ignore_unknown_usernames bool -
default_redirect_uri string -
password_check_lifetime google.protobuf.Duration -
external_login_check_lifetime google.protobuf.Duration -
mfa_init_skip_lifetime google.protobuf.Duration -
second_factor_check_lifetime google.protobuf.Duration -
multi_factor_check_lifetime google.protobuf.Duration -

UpdateLoginPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateOIDCSettingsRequest

Field Type Description Validation
access_token_lifetime google.protobuf.Duration -
id_token_lifetime google.protobuf.Duration -
refresh_token_idle_expiration google.protobuf.Duration -
refresh_token_expiration google.protobuf.Duration -

UpdateOIDCSettingsResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateOrgIAMPolicyRequest

Field Type Description Validation
user_login_must_be_domain bool -

UpdateOrgIAMPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdatePasswordAgePolicyRequest

Field Type Description Validation
max_age_days uint32 -
expire_warn_days uint32 -

UpdatePasswordAgePolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdatePasswordComplexityPolicyRequest

Field Type Description Validation
min_length uint32 -
has_uppercase bool -
has_lowercase bool -
has_number bool -
has_symbol bool -

UpdatePasswordComplexityPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdatePrivacyPolicyRequest

Field Type Description Validation
tos_link string -
privacy_link string -
help_link string -

UpdatePrivacyPolicyResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateSMSProviderTwilioRequest

Field Type Description Validation
id string - string.min_len: 1
string.max_len: 200
sid string - string.min_len: 1
string.max_len: 200
sender_number string - string.min_len: 1
string.max_len: 200

UpdateSMSProviderTwilioResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateSMSProviderTwilioTokenRequest

Field Type Description Validation
id string - string.min_len: 1
string.max_len: 200
token string - string.min_len: 1
string.max_len: 200

UpdateSMSProviderTwilioTokenResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateSMTPConfigPasswordRequest

Field Type Description Validation
password string -

UpdateSMTPConfigPasswordResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateSMTPConfigRequest

Field Type Description Validation
sender_address string - string.min_len: 1
string.max_len: 200
sender_name string - string.min_len: 1
string.max_len: 200
tls bool -
host string - string.min_len: 1
string.max_len: 500
user string -

UpdateSMTPConfigResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

UpdateSecretGeneratorRequest

Field Type Description Validation
generator_type zitadel.settings.v1.SecretGeneratorType - enum.defined_only: true
enum.not_in: [0]
length uint32 -
expiry google.protobuf.Duration -
include_lower_letters bool -
include_upper_letters bool -
include_digits bool -
include_symbols bool -

UpdateSecretGeneratorResponse

Field Type Description Validation
details zitadel.v1.ObjectDetails -

View

Field Type Description Validation
database string -
view_name string -
processed_sequence uint64 -
event_timestamp google.protobuf.Timestamp The timestamp the event occured
last_successful_spooler_run google.protobuf.Timestamp -