# Kubernetes API Conventions

**Canonical:** https://apis.io/apis/style-guides/kubernetes/  
**Provider:** API Style Guides — https://apis.io/providers/style-guides/  
**Base URL:** https://github.com/kubernetes/community/  
**Documentation:** https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md

Kubernetes API Conventions is one of 11 APIs that [API Style Guides](https://apis.io/providers/style-guides/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include REST, Kubernetes, SIG Architecture, and CRD.

The Kubernetes API conventions document, maintained by SIG Architecture. Defines the "kind / apiVersion" object envelope, spec/status separation, resourceVersion-based optimistic concurrency, list semantics, label and selector validation, and the patterns used by every Kubernetes-native API (and by extension every CRD).

## Machine-readable artifacts (3)

- **StyleGuide** — https://github.com/kubernetes/community/blob/master/contributors/devel/sig-architecture/api-conventions.md
- **License** — https://github.com/kubernetes/community/blob/master/LICENSE
- **Scope**

## Other API Style Guides APIs (10)

- [Microsoft REST API Guidelines](https://apis.io/apis/style-guides/microsoft/)
- [Google API Improvement Proposals (AIPs)](https://apis.io/apis/style-guides/google-aip/)
- [Zalando RESTful API and Event Guidelines](https://apis.io/apis/style-guides/zalando/)
- [PayPal API Design Guidelines](https://apis.io/apis/style-guides/paypal/)
- [adidas API Guidelines](https://apis.io/apis/style-guides/adidas/)
- [Cisco REST API Design Guide](https://apis.io/apis/style-guides/cisco/)
- [Atlassian REST API Design Guidelines](https://apis.io/apis/style-guides/atlassian/)
- [Heroku Platform API Design Conventions](https://apis.io/apis/style-guides/heroku/)
- [GitLab API Style Guide](https://apis.io/apis/style-guides/gitlab/)
- [IETF HTTPAPI Working Group Drafts and RFCs](https://apis.io/apis/style-guides/ietf-httpapi/)

## Tags

REST, Kubernetes, SIG Architecture, CRD

---

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