Skip to content
Cratis

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 one with the same endpoint name already exists. It is explicitly anonymous in every environment, including Production; 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 for TDetails.
  • If your provider only implements non-generic IProvideIdentityDetails, Arc generates schema for object.
  • 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.