Workflow Rejection Endpoint

Summary

Rejection accepts an optional comment and returns the updated rejected instance. Its exact method and route are in the endpoint catalog.

Processing

The command requires tenant context, loads the instance by task and requires Running/Pending state. The aggregate rejects the task, appends action data, marks the instance Rejected, records completion time and raises rejection events.

Results

Missing task data returns not-found. Non-running instances and nonpending tasks return conflict. Success returns the full instance DTO.

Limitations

Sibling tasks at the rejected stage are not changed by this action. No assignment authorization is enforced.

Requires Confirmation

Sibling-task finalization, rejection-reason requirements and decision authorization require confirmation.

Source References

• microservices/src/workflow-service/Api/WorkflowEndpoints.cs
• microservices/src/workflow-service/Application/Commands/WorkflowInstanceCommands.cs
• microservices/src/workflow-service/Domain/Workflow/WorkflowInstance.cs

Related Articles

• API overview
• Endpoint catalog
• API limitations

See Also

• Technical documentation
• Workflow business documentation

Keywords

Workflow API, approval endpoint, Workflow Service.

Revision Information

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