# URI Path Versioning

**Canonical:** https://apis.io/apis/versioning-protocols/uri-path-versioning/  
**Provider:** Versioning Protocols — https://apis.io/providers/versioning-protocols/  
**Documentation:** https://www.askantech.com/api-versioning-strategies-rest-header-url-deprecation-guide/

URI Path Versioning is one of 5 APIs that [Versioning Protocols](https://apis.io/providers/versioning-protocols/) publishes on the [APIs.io](https://apis.io/) network. This API exposes 1 JSON Schema definition. Tagged areas include URI Versioning, Path Versioning, REST, and API Design. The published artifact set on APIs.io includes API documentation and 1 JSON Schema.

URI path versioning embeds the API version in the URL path, typically as the major version number (e.g., /v1/users, /v2/users). The most widely adopted strategy for public REST APIs due to its explicitness, cache-friendliness, and ease of documentation. Minor and patch changes are deployed in place under the same major version path.

## Machine-readable artifacts (2)

- **Documentation** — https://www.askantech.com/api-versioning-strategies-rest-header-url-deprecation-guide/
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/versioning-protocols/refs/heads/main/json-schema/versioning-protocols-uri-path-versioning-schema.json

## Other Versioning Protocols APIs (4)

- [Semantic Versioning (SemVer)](https://apis.io/apis/versioning-protocols/semver/)
- [Calendar Versioning (CalVer)](https://apis.io/apis/versioning-protocols/calver/)
- [Header-Based Versioning](https://apis.io/apis/versioning-protocols/header-versioning/)
- [OpenAPI Versioning](https://apis.io/apis/versioning-protocols/openapi-versioning/)

## Tags

URI Versioning, Path Versioning, REST, API Design

---

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