Introspection
Arc exposes introspection endpoints that let you inspect the command and query surface of your application at runtime.
Where to find the endpoints
Section titled “Where to find the endpoints”When you call UseCratisArc(), Arc maps introspection endpoints automatically.
/.cratis/commands/.cratis/queries/.cratis/identity-details/schema(when an identity details provider is registered)
These endpoints are mapped in both Arc.Core and ASP.NET Core hosting scenarios through MapIntrospectionEndpoints().
Automatically called when just using the out-of-the-box general builders for setting up an Arc or a Cratis application.
What introspection does
Section titled “What introspection does”Introspection returns metadata, not business data. It helps you:
- Discover available command and query endpoints.
- Understand route paths and operation names.
- Read operation summaries populated from type metadata.
- Build tooling, diagnostics, and client-side discovery workflows.
Topics
Section titled “Topics”| Topic | Description |
|---|---|
| Commands | Metadata shape and behavior for /.cratis/commands. |
| Queries | Metadata shape and behavior for /.cratis/queries. |
| Identity details schema | JSON Schema shape for /.cratis/identity-details/schema. |