Update Task Status Command

Command to change a task's status in the workflow

Command Command

Overview

The UpdateTaskStatusCommand transitions a task to a different workflow state.

Example

{
  "commandId": "cmd_status_789",
  "commandType": "UpdateTaskStatusCommand",
  "timestamp": "2025-12-11T16:00:00Z",
  "version": "1.0.0",
  "data": {
    "taskId": "task_12345",
    "workspaceId": "ws_acme_corp",
    "newStatus": "in_progress",
    "changedBy": {
      "userId": "usr_jane_smith",
      "name": "Jane Smith"
    },
    "reason": "Started implementation"
  }
}

Validation Rules

  • Status must be valid for workflow
  • Task must exist
  • Transition must be allowed by workflow rules
  • User must have permission

Results

Success: TaskStatusChanged event is published If status is “done”: TaskCompleted event is also published

Edit this page