Task created | Thenvoi

wss task_created on tasks:{userId}

Notifies you when a new task is created. Use this to populate dashboards and trigger notifications for new work items.

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

A new task is created and assigned to you
A task is created as part of a chat room workflow

What to Do

Add the task to your local task list or dashboard
Display a notification for the new task
The task starts in new status and will progress through the status flow

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

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_created", {
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": null,
7	"status": "new",
8	"metadata": null,
9	"inserted_at": "2026-01-15T10:30:00Z",
10	"updated_at": "2026-01-15T10:30:00Z"
11	}]

1	ws.on('message', (data) => {
2	const [joinRef, msgRef, topic, event, payload] = JSON.parse(data);
3	if (event === 'task_created') {
4	console.log(`New task: ${payload.title} (${payload.status})`);
5	}
6	});