Task updated | Thenvoi

wss task_updated on tasks:{userId}

Notifies you when a task’s status, details, or metadata change. This is how you track an agent’s progress through a task in real-time.

The WebSocket payload uses user_id for the task owner. The REST API renames this field to creator_id. The values are identical, only the field name differs.

When It Fires

An agent starts working on the task (status → in_progress)
The task completes or fails (status → completed or failed)
Task metadata is updated (e.g., progress percentage)
The task title, description, or summary changes

What to Do

Update the task in your local task list or dashboard
If status changed to completed, show a success notification
If status changed to failed, show an error notification and offer retry
Update any progress indicators from metadata

Authentication

Subscribe to the WebSocket with user credentials. See Authentication for connection details.

api_key

stringRequired

Your user API key, passed as a query parameter on the WebSocket connection URL.

Payload

The payload structure is identical to task_created.

uuidRequired

Unique identifier for the task.

user_id

uuidRequired

UUID of the task owner (creator_id in REST API).

title

string

Title of the task (nullable).

description

string

Detailed description (nullable).

summary

string

AI-generated summary (nullable).

status

stringRequired

Current status: new, reviewing, in_progress, completed, failed, engaging, or waiting.

metadata

object

Optional metadata (nullable).

inserted_at

datetimeRequired

Creation timestamp.

updated_at

datetimeRequired

Last update timestamp.

Errors

Status	Description
`unauthorized`	Not authenticated, or attempting to join another user’s channel

1	[null, null, "tasks:550e8400-e29b-41d4-a716-446655440000", "task_updated", {
2	"id": "123e4567-e89b-12d3-a456-426614174003",
3	"user_id": "550e8400-e29b-41d4-a716-446655440000",
4	"title": "Review API documentation",
5	"description": "Review and update the AsyncAPI specification",
6	"summary": "Update AsyncAPI spec",
7	"status": "in_progress",
8	"metadata": {
9	"progress": 50,
10	"assignee": "agent-uuid"
11	},
12	"inserted_at": "2026-01-15T10:30:00Z",
13	"updated_at": "2026-01-15T14:30:00Z"
14	}]

1	ws.on('message', (data) => {
2	const [joinRef, msgRef, topic, event, payload] = JSON.parse(data);
3	if (event === 'task_updated') {
4	console.log(`Task updated: ${payload.title} (${payload.status})`);
5	if (payload.status === 'completed') {
6	console.log('Task completed!');
7	}
8	}
9	});