Update Secret Generator​
Change a specific secret generator configuration by its type (e.g PasswordResetCode). A generator defines how a secret should look when generating in ZITADEL.
Path Parameters
generatorType string required
Possible values: [SECRET_GENERATOR_TYPE_UNSPECIFIED
, SECRET_GENERATOR_TYPE_INIT_CODE
, SECRET_GENERATOR_TYPE_VERIFY_EMAIL_CODE
, SECRET_GENERATOR_TYPE_VERIFY_PHONE_CODE
, SECRET_GENERATOR_TYPE_PASSWORD_RESET_CODE
, SECRET_GENERATOR_TYPE_PASSWORDLESS_INIT_CODE
, SECRET_GENERATOR_TYPE_APP_SECRET
, SECRET_GENERATOR_TYPE_OTP_SMS
, SECRET_GENERATOR_TYPE_OTP_EMAIL
]
application/json
application/grpc
application/grpc-web+proto
Request Body required
length int64
expiry string
includeLowerLetters boolean
includeUpperLetters boolean
includeDigits boolean
includeSymbols boolean
Request Body required
length int64
expiry string
includeLowerLetters boolean
includeUpperLetters boolean
includeDigits boolean
includeSymbols boolean
Request Body required
length int64
expiry string
includeLowerLetters boolean
includeUpperLetters boolean
includeDigits boolean
includeSymbols boolean
Responses
- 200
- 403
- 404
- default
A successful response.
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2024-06-13T06:44:38.839Z",
"changeDate": "2024-06-13T06:44:38.839Z",
"resourceOwner": "69629023906488334"
}
}
Schema
Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2024-06-13T06:44:38.839Z",
"changeDate": "2024-06-13T06:44:38.839Z",
"resourceOwner": "69629023906488334"
}
}
Schema
Example (from schema)
Schema
details object
{
"details": {
"sequence": "2",
"creationDate": "2024-06-13T06:44:38.839Z",
"changeDate": "2024-06-13T06:44:38.839Z",
"resourceOwner": "69629023906488334"
}
}
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[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"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[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"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[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
Schema
Example (from schema)
Schema
code int32
message string
details object[]
{
"code": 0,
"message": "string",
"details": [
{
"@type": "string"
}
]
}
PUT /secretgenerators/:generatorType
Authorization
name: OAuth2type: oauth2scopes:openid,urn:zitadel:iam:org:project:id:zitadel:aud
flows: { "authorizationCode": { "authorizationUrl": "$CUSTOM-DOMAIN/oauth/v2/authorize", "tokenUrl": "$CUSTOM-DOMAIN/oauth/v2/token", "scopes": { "openid": "openid", "urn:zitadel:iam:org:project:id:zitadel:aud": "urn:zitadel:iam:org:project:id:zitadel:aud" } } }
Request
Request
curl / cURL
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
python / requests
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
go / native
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
nodejs / axios
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
ruby / Net::HTTP
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
csharp / RestSharp
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
php / cURL
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
java / OkHttp
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'
powershell / RestMethod
curl -L -X PUT 'https://$CUSTOM-DOMAIN/admin/v1/secretgenerators/:generatorType' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
"length": 6,
"expiry": "3600s",
"includeLowerLetters": true,
"includeUpperLetters": true,
"includeDigits": true,
"includeSymbols": true
}'