Skip to content

Add API versioning with consistent route structure #563

Description

@Wilfred007

What

Routes exist at both /api/ and /api/v1/. The apiVersionMiddleware exists but versioning is not consistently applied. Some routes are duplicated.

Why

Breaking changes will affect existing integrations. Inconsistent versioning makes API evolution impossible.

Scope

In scope: All routes under /api/v1/, /api/ as alias with deprecation header
Out of scope: v2 routes

Acceptance Criteria

  • All routes accessible under /api/v1/
  • /api/ routes return deprecation warning header
  • Version in response header
  • No breaking changes to v1

Technical Context

  • backend/src/middlewares/apiVersionMiddleware.ts — versioning middleware
  • backend/src/routes/v1/ — v1 routes
  • backend/src/app.ts — route mounting (both /api/ and /api/v1/)

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    GrantFox OSSIssue tracked in GrantFox OSSMaybe RewardedIssue may be eligible for a GrantFox rewardThird CampaignCampaign: Third CampaignbackendBackend developmentmediumModerate tasks

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions