REQ-FUN-045

REST API versioned via URL prefix (/v1/...); breaking changes increment version

ID
REQ-FUN-045
Category
Functional Requirements
Status
approved
Priority
P0
Created
2026-05-10T18:00:14.543Z
Approved
2026-05-10T18:02:48.699Z
Updated
2026-05-10T18:02:48.699Z

What

The REST API SHALL be versioned via URL prefix (/v1/...); breaking changes increment the version.

Acceptance

Version negotiated; /v1 stable through initial release.

Source

OBJ-1.

established project management guidelines Mapping

Primary Knowledge Area
Integration Management
Secondary KAs
none
Primary Process Group
Planning
established project management guidelines Deliverables
Change Management Plan, Project Management Plan

URL-prefix versioning is the Configuration / Change management policy for breaking interface changes.