# TypeSpec

**Canonical:** https://apis.io/apis/specifications/typespec/  
**Provider:** API Specifications — https://apis.io/providers/specifications/  
**Base URL:** https://typespec.io/docs  
**Documentation:** https://typespec.io/

TypeSpec is one of 13 APIs that [API Specifications](https://apis.io/providers/specifications/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include TypeSpec, Microsoft, IDL, API Design, and Specification Language. The published artifact set on APIs.io includes API documentation and a GitHub repository.

TypeSpec (formerly Cadl) is a language for describing API shapes developed by Microsoft. TypeSpec definitions emit OpenAPI 3.x, JSON Schema, Protobuf, and other artifacts, and serve as the upstream source for Azure SDK generation. TypeSpec is MIT licensed and maintained on GitHub under the microsoft organization.

## Machine-readable artifacts (7)

- **Documentation** — https://typespec.io/docs
- **Specification** — https://typespec.io/docs/language-basics/overview
- **GitHubRepository** — https://github.com/microsoft/typespec
- **GitHubOrganization** — https://github.com/microsoft
- **Governance** — https://github.com/microsoft/typespec/blob/main/GOVERNANCE.md
- **License** — https://opensource.org/license/mit
- **Examples** — https://raw.githubusercontent.com/api-evangelist/specifications/refs/heads/main/examples/typespec-example.json

## Other API Specifications APIs (12)

- [OpenAPI Specification (OAS)](https://apis.io/apis/specifications/openapi/)
- [AsyncAPI Specification](https://apis.io/apis/specifications/asyncapi/)
- [JSON Schema](https://apis.io/apis/specifications/json-schema/)
- [JSON Structure](https://apis.io/apis/specifications/json-structure/)
- [GraphQL SDL](https://apis.io/apis/specifications/graphql/)
- [gRPC and Protocol Buffers](https://apis.io/apis/specifications/grpc-protobuf/)
- [Smithy](https://apis.io/apis/specifications/smithy/)
- [RAML (RESTful API Modeling Language)](https://apis.io/apis/specifications/raml/)
- [API Blueprint](https://apis.io/apis/specifications/api-blueprint/)
- [WSDL / SOAP](https://apis.io/apis/specifications/wsdl-soap/)
- [JSON-RPC 2.0](https://apis.io/apis/specifications/json-rpc/)
- [Tinybird API Spec](https://apis.io/apis/specifications/tinybird/)

## Tags

TypeSpec, Microsoft, IDL, API Design, Specification Language

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/specifications/typespec/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/specifications/.