Endpoint: POST /v2/task/

This endpoint allows users to create a new chat task. This task enables the agent to handle more complex, ongoing interactions or tasks that require multiple steps or extended processing time. The request includes details such as the user ID, agent ID, session ID, and the message. Once the task is created, a unique task ID is returned to track the progress of the task.

Parameters

user_id
string
required

The unique identifier of the user initiating the task.

agent_id
string
required

The unique identifier of the agent assigned to the task.

session_id
string
required

The session ID to maintain task context across multiple queries.

message
string
required

The user’s message or request that defines the task.

Response Parameters

task_id
string

The unique identifier for the created task.