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 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] 
- 200
 - 403
 - 404
 - default
 
A successful response.
- application/json
 - application/grpc
 - application/grpc-web+proto
 
- Schema
 - Example (from schema)
 
Schema
secretGenerator object
generatorType stringPossible 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_UNSPECIFIEDdetails 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
creationDate date-timeon read: the timestamp of the first event of the object
on create: 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
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-12",
      "changeDate": "2023-05-12",
      "resourceOwner": "69629023906488334"
    },
    "length": 6,
    "expiry": "3600s",
    "includeLowerLetters": true,
    "includeUpperLetters": true,
    "includeDigits": true,
    "includeSymbols": true
  }
}
- Schema
 - Example (from schema)
 
Schema
secretGenerator object
generatorType stringPossible 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_UNSPECIFIEDdetails 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
creationDate date-timeon read: the timestamp of the first event of the object
on create: 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
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-12",
      "changeDate": "2023-05-12",
      "resourceOwner": "69629023906488334"
    },
    "length": 6,
    "expiry": "3600s",
    "includeLowerLetters": true,
    "includeUpperLetters": true,
    "includeDigits": true,
    "includeSymbols": true
  }
}
- Schema
 - Example (from schema)
 
Schema
secretGenerator object
generatorType stringPossible 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_UNSPECIFIEDdetails 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
creationDate date-timeon read: the timestamp of the first event of the object
on create: 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
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-12",
      "changeDate": "2023-05-12",
      "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"
    }
  ]
}