OpenAPI
Core Principles
Built-in, not Swashbuckle
— .NET 10 ships
Microsoft.AspNetCore.OpenApi
as the official, framework-maintained OpenAPI solution. Swashbuckle was removed from templates in .NET 9 and is no longer recommended.
TypedResults drive the schema
—
TypedResults.Ok()
automatically generates correct OpenAPI response schemas.
Results.Ok()
does not. Always use
TypedResults
.
Transformers over workarounds
— Document, operation, and schema transformers compose cleanly. Use them for security schemes, global responses, and schema customization.
Metadata on every endpoint
— Use
.WithName()
,
.WithSummary()
,
.WithTags()
on every endpoint. This metadata feeds directly into the OpenAPI spec and client generators.
Patterns
Basic Setup
var
builder
=
WebApplication
.
CreateBuilder
(
args
)
;
builder
.
Services
.
AddOpenApi
(
)
;
var
app
=
builder
.
Build
(
)
;
Show more
Installs
1.1K
Repository
codewithmukesh/…aude-kit
GitHub Stars
703
First Seen
Mar 13, 2026
Security Audits
Gen Agent Trust Hub
Pass
Socket
Pass
Snyk
Pass