Task

Included from Basic tier

A task is one node background task: an actions-refresh discovery run (GenerateActionsRequest) or a MintModel concretise run (MintModelConcretiseTask) recorded against a node and executed on a runner. Tasks are created by a manual actions refresh or by MintModel generation, progress through a small status lifecycle, and can be cancelled while active. Served by the v2 TaskService (ListTasks, GetTask, CreateTask, CancelTask); reads gate on the node path, creates require update on it, cancels require delete.

Task

Task is one node_background_tasks row — the v1 node_background_task serialization typed. actions_json (the full stored actions trees) is only set on GetTask, the v1 show-only contract; its log lines read through LogService.ReadLogLines with the task id as run and step id.

Field	Type	Meaning
actions_count	integer	How many top-level actions the task's stored trees carry; 0 until discovery finishes.
actions_json	string	The stored actions trees as JSON text; empty outside GetTask.
build_without_cache	boolean	Whether the task was asked to rebuild without the runner's image/derivation cache.
created_at	timestamp	When the record was created.
created_by	string	Username of the creating identity.
error_message	string	The failure message when the task finalised in error; unset otherwise.
id	string	The record's identity — also the run and step id its log lines read under.
node_path	string	The owning node's canonical path.
project_code	string	The owning project's code.
request_number	integer	The task's per-node ordinal, assigned at create; listings order by it newest first.
status_code	string	initializing | running | success | error | cancelled.
task_type	string	GenerateActionsRequest or MintModelConcretiseTask.
template_id	string	The template the task derived against.
template_version_history_id	string	The node's template-version-history row the task ran under (every task records one).
template_version_id	string	The template version the task derived against (the pinned version unless the create named one).
updated_at	timestamp	When the record was last updated.
version	string	The template version's label.

Related pages

• opschain docs resources/activity — tasks join the activity feed on the background-tasks opt-in.
• opschain docs resources/template — the template versions tasks derive against.
• opschain docs resources/mintmodel — the MintModel concretise task's subject.