---
id: GOV_API_VERSIONING
type: standard
status: active
tier: T1
title: api-versioning
description: Governance rules for api-versioning.
applies_when:
  - "url versioning"
  - "accept header version"
  - "sunset header"
  - "deprecation policy"
---

# api-versioning (current)

This document records the current governance decision for the api-versioning area. It states the recommended approach, the rationale behind it, and how to request an exception.

## Decision

- Adopt the documented pattern for this area.
- Prefer the recommended approach over ad-hoc alternatives.
- Record any deviation in the project decision record.
- Consult this page before related work begins.
