Skip to main content

Workflow API Versioning

Summary​

No HTTP API versioning library, version segment, version header, version policy or version-specific route registration was found.

Important distinction​

Workflow definition versions are business/runtime resources embedded in definition DTOs. They are not HTTP API contract versions.

Current contract​

One unversioned native route group is mapped. OpenAPI generation is registered without verified version grouping.

Compatibility​

No legacy/compatibility Workflow API exists to provide an alternate contract generation.

Requires Confirmation​

Contract evolution, breaking-change policy, OpenAPI document version and future route versioning require confirmation.

Source References​

  • microservices/src/workflow-service/Program.cs
  • microservices/src/workflow-service/Api/WorkflowEndpoints.cs
  • microservices/src/workflow-service/Application/Dtos.cs

See Also​

Keywords​

Workflow API, approval endpoint, Workflow Service.

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-20
  • Next review: 2026-10-20