Skip to content

Identity details schema

A frontend or tool that shows identity details from another language cannot import your detailsType class. It can read its schema instead. GET /.cratis/identity-details/schema returns the JSON Schema of the details object that /.cratis/me returns. The schema comes from the identity details provider:

ConfigurationResponse
A provider with detailsTypeJSON Schema derived from the class’s @field declarations
A provider with a Zod schemaThat schema converted to JSON Schema
No provider, legacy identityDetailsSchema optionThat object, unchanged
Neither{}

For a detailsType with one @field(String) greeting field:

{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"greeting":{"type":"string"}},"required":["greeting"],"additionalProperties":false}

The endpoint follows the shared discovery access policy: anonymous in Development, authenticated elsewhere by default. It describes the shape only, never a user’s data. The legacy identityDetailsSchema option cannot be combined with identityDetails.