Get the password expiry settings
GET/v2/settings/password/expiry
Return the password expiry settings for the requested context
Request​
Query Parameters
Responses​
- 200
- 403
- 404
- default
OK
- application/json
- application/grpc
- application/grpc-web+proto
- Schema
- Example (from schema)
Schema
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 last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
settings
object
Amount of days after which a password will expire. The user will be forced to change the password on the following authentication.
Amount of days after which the user should be notified of the upcoming expiry. ZITADEL will not notify the user.
Possible values: [RESOURCE_OWNER_TYPE_UNSPECIFIED
, RESOURCE_OWNER_TYPE_INSTANCE
, RESOURCE_OWNER_TYPE_ORG
]
Default value: RESOURCE_OWNER_TYPE_UNSPECIFIED
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.297Z",
"resourceOwner": "69629023906488334"
},
"settings": {
"maxAgeDays": "365",
"expireWarnDays": "10",
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
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 last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
settings
object
Amount of days after which a password will expire. The user will be forced to change the password on the following authentication.
Amount of days after which the user should be notified of the upcoming expiry. ZITADEL will not notify the user.
Possible values: [RESOURCE_OWNER_TYPE_UNSPECIFIED
, RESOURCE_OWNER_TYPE_INSTANCE
, RESOURCE_OWNER_TYPE_ORG
]
Default value: RESOURCE_OWNER_TYPE_UNSPECIFIED
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.298Z",
"resourceOwner": "69629023906488334"
},
"settings": {
"maxAgeDays": "365",
"expireWarnDays": "10",
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
- Schema
- Example (from schema)
Schema
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 last event reduced by the projection
on manipulation: the timestamp of the event(s) added by the manipulation
settings
object
Amount of days after which a password will expire. The user will be forced to change the password on the following authentication.
Amount of days after which the user should be notified of the upcoming expiry. ZITADEL will not notify the user.
Possible values: [RESOURCE_OWNER_TYPE_UNSPECIFIED
, RESOURCE_OWNER_TYPE_INSTANCE
, RESOURCE_OWNER_TYPE_ORG
]
Default value: RESOURCE_OWNER_TYPE_UNSPECIFIED
{
"details": {
"sequence": "2",
"changeDate": "2024-12-20T16:04:44.298Z",
"resourceOwner": "69629023906488334"
},
"settings": {
"maxAgeDays": "365",
"expireWarnDays": "10",
"resourceOwnerType": "RESOURCE_OWNER_TYPE_UNSPECIFIED"
}
}
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
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"
}
]
}
Returned when the resource does not exist.
- 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"
}
]
}
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"
}
]
}