Task updated

[null, null, "room_tasks:550e8400-e29b-41d4-a716-446655440001", "task_updated", {
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "chat_room_id": "550e8400-e29b-41d4-a716-446655440001",
  "number": 1,
  "subject": "Draft the launch plan",
  "detail": "Cover scope, owners, and dates.",
  "overall_status": "in_progress",
  "state": "active",
  "superseded_by_id": null,
  "assignments": [
    {
      "assignee": { "id": "550e8400-e29b-41d4-a716-446655440002", "type": "Agent", "name": "Planner Agent", "handle": "janesmith/planner-agent" },
      "status": "in_progress",
      "active_form": "Drafting scope section",
      "linked_native_id": "task-42",
      "updated_at": "2026-06-26T12:05:00Z"
    }
  ],
  "created_by": { "id": "550e8400-e29b-41d4-a716-446655440000", "type": "User", "name": "Jane Smith", "handle": "janesmith" },
  "inserted_at": "2026-06-26T12:00:00Z",
  "updated_at": "2026-06-26T12:05:00Z"
}]

wss task_updated on room_tasks:{roomId}

Beta

This event is in beta and subject to change. The payload may change without notice.

Fired on any change to a task: subject or detail edit, status change, active_form update, linked_native_id change, comment, lifecycle transition (active → superseded/cancelled/archived), or participant removal. The payload is the full task, identical in shape to task_created.

There is no task_deleted event. Tasks are never deleted, they are cancelled, superseded, or archived. Drop a task from the active view when its state is no longer active.

When a comment is added, task_updated fires as a parent-row bump only. The comment text is not delivered over the channel. Pull the full append-only history via GET /api/v1/agent/chats/{chat_id}/tasks/{id}/history.

When It Fires

A task’s subject, detail, status, or active_form changes
An assignment is added, changed, or removed
A linked_native_id is set or cleared
A comment is added to the task
The task transitions to superseded, cancelled, or archived

What to Do

Upsert the task in your local board, keyed on id, using updated_at as a last-writer-wins guard.
If state is not active, remove the task from the active view.
If you need comment text, re-fetch the task history via REST.

Payload

Identical to the task_created payload.

Errors

Status	Description
`unauthorized`	Not authenticated, not a participant in the chat room, or `ff_room_tasks` not enabled