Skip to main content

Workflow Version API Behavior

Summary​

Workflow versions are embedded in full definition responses and definition mutation behavior. No standalone version endpoint is implemented.

Embedded representation​

Each version DTO includes identity, number, publication flag/time, ordered step DTOs and ordered condition DTOs. Definition detail and mutation responses expose the version collection.

Mutation behavior​

Definition update can replace the current draft steps. When no draft exists after publication, the domain model creates the next version. Publication operates through the definition publication operation.

Not implemented​

There is no version list/detail route, compare, rollback, delete, clone or explicit create-version request.

Requires Confirmation​

Whether Epic 17.3 consumers require independent version resources or embedded versions remain canonical requires confirmation.

Source References​

  • microservices/src/workflow-service/Api/WorkflowEndpoints.cs
  • microservices/src/workflow-service/Application/Dtos.cs
  • microservices/src/workflow-service/Domain/Workflow/WorkflowDefinition.cs

See Also​

Keywords​

Workflow API, approval endpoint, Workflow Service.

Revision Information​

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