Get instance level features​
Returns all configured features for an instance. Unset fields mean the feature is the current system default.
Query Parameters
inheritance boolean
Inherit unset features from the resource owners. This option is recursive: if the flag is set, the resource's ancestors are consulted up to system defaults. If this option is disabled and the feature is not set on the instance, it will be omitted from the response or Not Found is returned when the instance has no features flags at all.
Responses
- 200
- 403
- 404
- default
OK
application/json
application/grpc
application/grpc-web+proto
Schema
Example (from schema)
Schema
details object
loginDefaultOrg object
oidcTriggerIntrospectionProjections object
oidcLegacyIntrospection object
userSchema object
oidcTokenExchange object
{
"details": {
"sequence": "2",
"changeDate": "2024-03-27T10:05:49.891Z",
"resourceOwner": "69629023906488334"
},
"loginDefaultOrg": true,
"oidcTriggerIntrospectionProjections": true,
"oidcLegacyIntrospection": true,
"userSchema": true,
"oidcTokenExchange": true
}
Schema
Example (from schema)
Schema
details object
loginDefaultOrg object
oidcTriggerIntrospectionProjections object
oidcLegacyIntrospection object
userSchema object
oidcTokenExchange object
{
"details": {
"sequence": "2",
"changeDate": "2024-03-27T10:05:49.892Z",
"resourceOwner": "69629023906488334"
},
"loginDefaultOrg": true,
"oidcTriggerIntrospectionProjections": true,
"oidcLegacyIntrospection": true,
"userSchema": true,
"oidcTokenExchange": true
}
Schema
Example (from schema)
Schema
details object
loginDefaultOrg object
oidcTriggerIntrospectionProjections object
oidcLegacyIntrospection object
userSchema object
oidcTokenExchange object
{
"details": {
"sequence": "2",
"changeDate": "2024-03-27T10:05:49.892Z",
"resourceOwner": "69629023906488334"
},
"loginDefaultOrg": true,
"oidcTriggerIntrospectionProjections": true,
"oidcLegacyIntrospection": true,
"userSchema": true,
"oidcTokenExchange": 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[]
{
"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 has no feature flag settings and inheritance from the parent is disabled.
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"
}
]
}
GET /v2beta/features/instance
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 GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
python / requests
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
go / native
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
nodejs / axios
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
ruby / Net::HTTP
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
csharp / RestSharp
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
php / cURL
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
java / OkHttp
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'
powershell / RestMethod
curl -L -X GET 'https://$CUSTOM-DOMAIN/v2beta/features/instance' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>'