Agent tasks
Agent tasks
Asynchronous work such as memory chat, search, explore memories, explore product, and chat completions.
Agent tasks represent asynchronous work such as memory chat, memory search, explore memories, explore product, 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, EXPLORE_MEMORIES, EXPLORE_PRODUCT, 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. |