Introspection Identity Details Schema Endpoint
The identity details schema introspection endpoint returns JSON Schema for the identity details contract exposed by your configured identity details provider.
Endpoint
Section titled “Endpoint”GET /.cratis/identity-details/schema
When Arc maps this endpoint
Section titled “When Arc maps this endpoint”Normal Arc identity activation maps this endpoint unless Introspection.IdentityDiscovery is false, one with the same endpoint name already exists, or the host cannot enforce its discovery access settings. Like the other four discovery endpoints, it follows Introspection.RequireAuthentication and Introspection.Roles: anonymous in Development and authenticated elsewhere by default. Outside Development, a host without authentication leaves it unmapped and logs a warning; explicitly requiring authentication on such a host fails startup. Setting Introspection.Enabled to false disables only the command and query catalogs, not this endpoint. Set both Enabled and IdentityDiscovery to false to remove every discovery endpoint without authentication enforcement checks or exposure warnings; /.cratis/me is unchanged. See production access.
What it returns
Section titled “What it returns”The endpoint returns a JSON Schema document generated from the runtime identity details type:
- If your provider implements
IProvideIdentityDetails<TDetails>, Arc generates schema forTDetails. - If your provider only implements non-generic
IProvideIdentityDetails, Arc generates schema forobject. - If no identity details provider is configured, Arc returns an empty schema object (
{}).
Typical uses
Section titled “Typical uses”- Discover the identity details shape at runtime without hardcoding provider types.
- Drive client-side tooling that validates or renders identity details data.
- Keep integration tests and diagnostics aligned with the active identity provider contract.