TypeSpec is an API description language developed by Microsoft for defining API shapes that compile to OpenAPI, JSON Schema, Protobuf, and other output formats. It provides a type-safe, composable language for describing REST APIs, gRPC services, and data schemas with built-in versioning, documentation, and extensibility via decorators.
URL: https://typespec.io
API Design, Code Generation, OpenAPI, Protocol Buffers, Specification Language
- Created: 2026-03-25
- Modified: 2026-05-03
Programmatic Node.js/TypeScript API for processing TypeSpec files, running emitters, and building TypeSpec tooling.
Human URL: https://typespec.io/docs
Tags: API Design, Code Generation, Compiler, Specification Language
Properties
Converts TypeSpec definitions to OpenAPI 3.0 specifications with HTTP operations, security schemes, and versioning.
Human URL: https://typespec.io/docs/emitters/openapi3/reference
Tags: Code Generation, OpenAPI, REST API
Properties
Emits JSON Schema documents from TypeSpec model definitions for data validation workflows.
Human URL: https://typespec.io/docs/emitters/json-schema/reference
Tags: Code Generation, JSON Schema, Validation
Properties
Emits .proto files for gRPC service definitions from TypeSpec source.
Human URL: https://typespec.io/docs/emitters/protobuf/reference
Tags: Code Generation, gRPC, Protocol Buffers
Properties
Decorators and types for describing HTTP REST APIs: routes, operations, request bodies, parameters, headers, and response codes.
Human URL: https://typespec.io/docs/libraries/http/reference
Tags: Decorators, HTTP, REST API
Properties
Decorators for REST API resource patterns including CRUD, collection operations, and error shapes.
Human URL: https://typespec.io/docs/libraries/rest/reference
Tags: Decorators, Resource Pattern, REST API
Properties
| Schema | Description |
|---|---|
| Program | TypeSpec compiled program structure |
| Structure | Description |
|---|---|
| Model | TypeSpec model type structure |
FN: Kin Lane Email: kin@apievangelist.com