Schema
TaskResponse
Task response model.
| Field | Type | Description |
|---|---|---|
idrequired | string (uuid) | Task UUID |
permakey | string | null | Stable human-readable task/instance key for the nested deep-link URL .../cycles/{cycle}/instance/{permakey}. Null on legacy rows. |
cycle_idrequired | string (uuid) | Parent cycle UUID |
step_id | string | null | Blueprint step id this task corresponds to (FE OutputsViewer resolver) |
step_indexrequired | integer | Step index in workflow |
namerequired | string | Task name |
typerequired | string | Task type (domain type for display: extraction, validation, etc.) |
statusrequired | "pending" | "planning" | "pending_approval" | "upload_document" | "running" | "paused" | "blocked" | "awaiting_approval" | "approved" | "rejected" | "done" | "completed" | "failed" | "skipped" | Status for individual tasks.
Database constraint: pending, running, paused, blocked, done, skipped, failed
Additional API statuses: planning, pending_approval, awaiting_approval, approved, rejected, completedpendingplanningpending_approvalupload_documentrunningpausedblockedawaiting_approvalapprovedrejecteddonecompletedfailedskipped |
requires_approval | boolean | Whether task requires approval |
input_data | object | Task inputshow nestedEmpty object. |
output_data | object | Task outputshow nestedEmpty object. |
error_message | string | null | Error message if failed |
started_at | string (date-time) | null | Start timestamp |
completed_at | string (date-time) | null | Completion timestamp |
approved_by | string (uuid) | null | Approver user ID |
approved_at | string (date-time) | null | Approval timestamp |
created_atrequired | string (date-time) | Creation timestamp |
updated_atrequired | string (date-time) | Last update timestamp |
cost_cents | integer | null | Real compute (token) cost of this step in pence. NULL/0 for seed/notify steps. |
cost_gbp | number | null | Real compute cost of this step in GBP (cost_cents / 100). NULL when no cost. |
reasoning_summary | string | null | The step's reasoning trace summary (workstreams.task.thinking_summary). NULL on older cycles or steps that recorded no reasoning. |
tokens_input | integer | null | Input tokens consumed by this step. NULL on legacy rows. |
tokens_output | integer | null | Output tokens produced by this step. NULL on legacy rows. |