Skip to main content

Workflow Task Endpoints

Summary​

The task surface consists of a caller worklist plus approve, reject and delegate actions. Exact routes appear only in the endpoint catalog.

Worklist​

The read operation returns Pending tasks whose user assignment matches caller email or whose role assignment matches any caller role. Results are ordered by creation time.

Actions​

Decision operations load an instance by task, require Running/Pending state and return typed application results. Approval and rejection return the updated instance; delegation returns the updated task.

Security boundary​

Caller identity and roles are resolved from ambient context, but action commands do not verify that the actor matches the selected task assignment.

Limitations​

There is no all-task listing, completed worklist, task detail, claim, bulk action or history endpoint.

Requires Confirmation​

Assignment enforcement, administrative task access and pagination require confirmation.

Source References​

  • microservices/src/workflow-service/Api/WorkflowEndpoints.cs
  • microservices/src/workflow-service/Application/Queries/WorkflowQueries.cs
  • microservices/src/workflow-service/Application/Commands/WorkflowInstanceCommands.cs

See Also​

Keywords​

Workflow API, approval endpoint, Workflow Service.

Revision Information​

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