Domain Model
Agent Task
Fields
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string.uuid | Yes | — | Id |
| createdAt | string.date-time | Yes | — | Created at |
| updatedAt | string.date-time | Yes | — | Updated at |
| taskType | string | Yes | — | Task type |
| sourceType | enum(event, conversation, schedule, operator, workflow, automation_rule) | Yes | — | Source type |
| sourceRefId | unknown | Yes | — | ID of the associated source ref |
| entityType | unknown | Yes | — | Entity type |
| entityId | unknown | Yes | — | ID of the associated entity |
| title | string | Yes | — | Title |
| description | unknown | Yes | — | Description |
| priority | number | Yes | — | Priority |
| status | enum(queued, planning, awaiting_approval, executing, blocked, completed, failed, canceled) | Yes | — | Status |
| assignedAgentRole | unknown | Yes | — | Assigned agent role |
| executionMode | enum(deterministic, agentic, hybrid) | Yes | — | Execution mode |
| approvalPolicy | enum(auto_execute, draft_for_review, agent_review, restricted) | Yes | — | Approval policy |
| dueAt | unknown | Yes | — | Due at |
| startedAt | unknown | Yes | — | Started at |
| completedAt | unknown | Yes | — | Completed at |
| failedAt | unknown | Yes | — | Failed at |
| lastError | unknown | Yes | — | Last error |
| workspaceVisible | boolean | Yes | — | Workspace visible |
| createdByUserId | unknown | Yes | — | ID of the associated created by user |
| workspaceId | string | Yes | — | ID of the associated workspace |
| metadata | unknown | Yes | — | Metadata |
Create Schema
Fields accepted when creating a new record:
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| taskType | string | Yes | — | Task type |
| sourceType | enum(event, conversation, schedule, operator, workflow, automation_rule) | Yes | — | Source type |
| sourceRefId | string | No | — | ID of the associated source ref |
| entityType | string | No | — | Entity type |
| entityId | string | No | — | ID of the associated entity |
| title | string | Yes | — | Title |
| description | string | No | — | Description |
| priority | integer | Yes | 100 | Priority |
| assignedAgentRole | string | No | — | Assigned agent role |
| executionMode | enum(deterministic, agentic, hybrid) | Yes | "agentic" | Execution mode |
| approvalPolicy | enum(auto_execute, draft_for_review, agent_review, restricted) | Yes | "draft_for_review" | Approval policy |
| dueAt | string.date-time | No | — | Due at |
| workspaceVisible | boolean | Yes | true | Workspace visible |
| createdByUserId | string | No | — | ID of the associated created by user |
| workspaceId | string | No | — | ID of the associated workspace |
| metadata | object | No | — | Metadata |
Update Schema
All fields are optional when updating:
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| taskType | string | No | — | Task type |
| entityType | string | No | — | Entity type |
| entityId | string | No | — | ID of the associated entity |
| title | string | No | — | Title |
| description | string | No | — | Description |
| priority | integer | No | 100 | Priority |
| assignedAgentRole | string | No | — | Assigned agent role |
| executionMode | enum(deterministic, agentic, hybrid) | No | "agentic" | Execution mode |
| approvalPolicy | enum(auto_execute, draft_for_review, agent_review, restricted) | No | "draft_for_review" | Approval policy |
| dueAt | string.date-time | No | — | Due at |
| workspaceVisible | boolean | No | true | Workspace visible |
| metadata | object | No | — | Metadata |