Workflow Message Contract Catalog
Audience
Developers, QA, support, architects and integration reviewers.
Summary
This catalog inventories exactly six Workflow-specific message contracts. All inherit the shared envelope and use schema version 1 when mapped.
Shared envelope
Every contract carries event identity/type/time, optional correlation/causation, optional shared tenant/user identity, source service and schema version. Workflow mapping sets numeric tenancy in contract payload rather than the shared tenant field.
Reference Content
| # | Contract | Purpose | Workflow payload | Version | Compatibility | Validation |
|---|---|---|---|---|---|---|
| 1 | WorkflowStartedEvent | Announce instance start | Numeric tenant, instance/definition/key, subject, initiator | 1 | Native only | Typed construction; no schema validator |
| 2 | WorkflowTaskCreatedEvent | Announce task creation | Numeric tenant, instance/task/key, stage/name/type, assignment | 1 | Native only | Typed construction; no schema validator |
| 3 | WorkflowTaskApprovedEvent | Announce task approval | Numeric tenant, instance/task/key, stage, actor | 1 | Native only | Typed construction; no schema validator |
| 4 | WorkflowTaskRejectedEvent | Announce task rejection | Numeric tenant, instance/task/key, stage, actor, optional reason | 1 | Native only | Typed construction; no schema validator |
| 5 | WorkflowCompletedEvent | Announce approved completion | Numeric tenant, instance/key and subject | 1 | Native only | Typed construction; no schema validator |
| 6 | WorkflowRejectedEvent | Announce rejected instance | Numeric tenant, instance/key, subject, actor, optional reason | 1 | Native only | Typed construction; no schema validator |
Serialization
Shared JSON serialization uses web defaults, omits null values and serializes using each concrete runtime record type.
Requires Confirmation
Schema governance, backward compatibility, registry/publication and payload validation require confirmation.
Source References
microservices/src/workflow-service/Messaging/WorkflowIntegrationEvents.csmicroservices/src/contracts/Events/IntegrationEvent.csmicroservices/src/shared-kernel/Outbox/IntegrationEventJsonSerializer.cs
Related Articles
See Also
Keywords
Workflow events, integration contracts, transactional outbox.
Revision Information
- Status: Draft
- Last reviewed: 2026-07-20
- Next review: 2026-10-20