Agent tasks
Agent tasks
Asynchronous work such as memory chat, search, and chat completions.
Agent tasks represent asynchronous work such as memory chat, memory search, or chat completions. Create a task by creating a session, then list or retrieve the task here. Poll or subscribe to webhooks to track status and results. Files a task produces are documented under Agent task files.
The agent task object
| Attribute | Type | Description |
|---|---|---|
id | string | The unique identifier of the agent task. |
createdAt | string | When the agent task was created. |
updatedAt | string | When the agent task was last updated. |
status | string | IN_PROGRESS, SUCCEEDED, or FAILED. |
taskType | string | Kind of task (MEMORY_CHAT, MEMORY_SEARCH, STREAMING_CHAT_COMPLETION, STRUCTURED_CHAT_COMPLETION). |
succeededAt | string | When the task completed successfully, if applicable. |
successResponse | object | Task-specific success payload when status is SUCCEEDED. |
failedAt | string | When the task failed, if applicable. |
failureResponse | object | Error details when status is FAILED. |
metadata | object | Custom key-value metadata for the agent task. |
conversationId | string | Conversation this task belongs to, if any. |
manualActionResults | array | Results recorded for any manual actions the task requested. |