2.5 View and Approve Workflow Notifications

View pending or in-progress human tasks generated by workflows. Human task notifications help you find workflow steps that require manual action, such as review or approval. The notification API lists human tasks; completing, approving, rejecting, or otherwise acting on the task is handled by updating the corresponding task status and output.

Workflow notifications are created for human tasks. Use human tasks when a workflow requires manual review, approval, rejection, or other human intervention before the workflow can continue.

When a workflow reaches a human task, MicroTx Workflows creates a notification for that task and keeps the task in progress until a user takes action. The workflow waits at that step and resumes only after the human task is updated. This is useful for approval flows, exception handling, compliance checks, and agentic workflows where an AI-generated recommendation or action must be reviewed before execution continues.

Before you begin, note the workflow instance ID of the workflow execution. You can use this ID to find the related workflow notification and review the workflow execution details before approving or rejecting the task.

To take an action on a workflow notification:
  1. Open the navigation menu and click Workflow Notification.

    All pending and in-progress human tasks that require action are displayed in a table.

  2. Use the search bar to filter notifications. You can search by values such as workflow name, task name, task ID, or workflow instance ID.
  3. Identify the workflow notification on which you want to act.
  4. Optional. Open the related workflow execution details to review the workflow input, output, task history, and current execution state before taking action.
  5. Click act icon (Act) under Actions.

    The Take Action on Task dialog box appears.

  6. In the Status drop-down list, select one of the following values:
    • Completed: Approves the notification and marks the human task as completed. The workflow continues to the next step based on the workflow definition.
    • Failed: Rejects the notification and marks the human task as failed. If you select this option, enter a reason in the Failure Reason field. The workflow then continues based on the failure handling logic defined in the workflow.
  7. Click Submit.
    A message is displayed that the task was updated successfully.
  8. Click OK.

After you take action, the notification no longer appears on the Workflow Notification page because the human task is no longer pending or in progress. MicroTx Workflows resumes processing the workflow based on the status you selected and the workflow's business logic.