Get Secret Generator
Get a specific secret generator by its type (e.g PasswordResetCode). A generator defines how a secret should look when generating in ZITADEL.
Path Parameters
- generatorType string requiredPossible 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]
- 200
- 403
- 404
- default
A successful response.
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
- secretGenerator objectgeneratorType string- 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]- Default value: - SECRET_GENERATOR_TYPE_UNSPECIFIED- details objectsequence uint64- on read: the sequence of the last event reduced by the projection - on manipulation: the timestamp of the event(s) added by the manipulation creationDate date-time- on read: the timestamp of the first event of the object - on create: the timestamp of the event(s) added by the manipulation changeDate date-time- on read: the timestamp of the last event reduced by the projection - on manipulation: the resourceOwner resource_owner is the organization an object belongs tolength int64expiry stringincludeLowerLetters booleanincludeUpperLetters booleanincludeDigits booleanincludeSymbols boolean
{
  "secretGenerator": {
    "generatorType": "SECRET_GENERATOR_TYPE_UNSPECIFIED",
    "details": {
      "sequence": "2",
      "creationDate": "2023-05-15",
      "changeDate": "2023-05-15",
      "resourceOwner": "69629023906488334"
    },
    "length": 6,
    "expiry": "3600s",
    "includeLowerLetters": true,
    "includeUpperLetters": true,
    "includeDigits": true,
    "includeSymbols": true
  }
}
- Schema
- Example (from schema)
Schema
- secretGenerator objectgeneratorType string- 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]- Default value: - SECRET_GENERATOR_TYPE_UNSPECIFIED- details objectsequence uint64- on read: the sequence of the last event reduced by the projection - on manipulation: the timestamp of the event(s) added by the manipulation creationDate date-time- on read: the timestamp of the first event of the object - on create: the timestamp of the event(s) added by the manipulation changeDate date-time- on read: the timestamp of the last event reduced by the projection - on manipulation: the resourceOwner resource_owner is the organization an object belongs tolength int64expiry stringincludeLowerLetters booleanincludeUpperLetters booleanincludeDigits booleanincludeSymbols boolean
{
  "secretGenerator": {
    "generatorType": "SECRET_GENERATOR_TYPE_UNSPECIFIED",
    "details": {
      "sequence": "2",
      "creationDate": "2023-05-15",
      "changeDate": "2023-05-15",
      "resourceOwner": "69629023906488334"
    },
    "length": 6,
    "expiry": "3600s",
    "includeLowerLetters": true,
    "includeUpperLetters": true,
    "includeDigits": true,
    "includeSymbols": true
  }
}
- Schema
- Example (from schema)
Schema
- secretGenerator objectgeneratorType string- 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]- Default value: - SECRET_GENERATOR_TYPE_UNSPECIFIED- details objectsequence uint64- on read: the sequence of the last event reduced by the projection - on manipulation: the timestamp of the event(s) added by the manipulation creationDate date-time- on read: the timestamp of the first event of the object - on create: the timestamp of the event(s) added by the manipulation changeDate date-time- on read: the timestamp of the last event reduced by the projection - on manipulation: the resourceOwner resource_owner is the organization an object belongs tolength int64expiry stringincludeLowerLetters booleanincludeUpperLetters booleanincludeDigits booleanincludeSymbols boolean
{
  "secretGenerator": {
    "generatorType": "SECRET_GENERATOR_TYPE_UNSPECIFIED",
    "details": {
      "sequence": "2",
      "creationDate": "2023-05-15",
      "changeDate": "2023-05-15",
      "resourceOwner": "69629023906488334"
    },
    "length": 6,
    "expiry": "3600s",
    "includeLowerLetters": true,
    "includeUpperLetters": true,
    "includeDigits": true,
    "includeSymbols": true
  }
}
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"
    }
  ]
}