# Smithy IDL

**Canonical:** https://apis.io/apis/smithy/smithy-idl/  
**Provider:** Smithy — https://apis.io/providers/smithy/  
**Documentation:** https://smithy.io/2.0/

Smithy IDL is one of 2 APIs that [Smithy](https://apis.io/providers/smithy/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include IDL, API Design, and Specification. The published artifact set on APIs.io includes API documentation, a getting-started guide, and a GitHub repository.

The Smithy Interface Definition Language (IDL) is a specification for defining API models using shapes and traits. Models can be written in the Smithy IDL syntax or the JSON AST representation. Smithy 2.0 is the current stable version with improved nullability, enums, resource properties, and mixins.

## Machine-readable artifacts (5)

- **Documentation** — https://smithy.io/2.0/
- **Specification** — https://smithy.io/2.0/spec/
- **GettingStarted** — https://smithy.io/2.0/quickstart.html
- **GitHubRepository** — https://github.com/smithy-lang/smithy
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/smithy/refs/heads/main/apis.yml

## Other Smithy APIs (1)

- [Smithy CLI](https://apis.io/apis/smithy/smithy-cli/)

## Tags

IDL, API Design, Specification

---

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