Asset

Included from Basic tierassets

An asset is a templated estate node under a project or an environment: it pins a template version, owns its properties and settings documents, and is the node changes execute against. Creating one requires the pinned template version to exist, be unarchived, resolved and not disabled; archiving one with active changes refuses. Served by the v2 AssetService (ListAssets, GetAsset, CreateAsset, UpdateAsset, DeleteAsset, ListTemplateVersionHistory); list rows carry the pinned template identity, and the get adds MintModel validity, child assets and the latest background tasks.

Asset

Asset is the typed asset read shape: the v1 node serializer's asset attributes plus the pinned template identity (the v1 include=template,template_version read, resolved server-side) and the owned-document ids.

Field	Type	Meaning
archived	boolean	Whether the asset is archived. Toggled through UpdateAsset; a no-op toggle, or archiving while changes are active, refuses.
changes_execute	boolean	May the caller execute changes under this node (execute on /changes).
code	string	The record's code.
created_by	string	Username of the creating identity.
description	string	"" when never set.
id	string	The record's identity.
latest_background_tasks	array of AssetBackgroundTask	The asset's latest background tasks, newest first (the v1 include=latest_node_background_tasks list read) — populated on ListAssets rows; the asset show carries them on GetAssetResponse instead.
maintenance	NodeMaintenanceBadge	The active-maintenance badge; unset while the node is open (the v1 maintenance attribute).
name	string	Display name.
node_path	string	The asset's node path.
parent_path	string	The parent node's path (project or environment).
properties_id	string	The asset's owned properties/settings document ids.
settings_id	string	The asset's owned settings document id (the pair of properties_id).
task_active	boolean	True while a background task (actions generation, concretisation) runs against the asset — the v1 task_active attribute.
template_code	string	The pinned template's code; "" when the pin is unresolvable.
template_id	string	The pinned template's identity; "" when the catalog read model is not composed or the pin is unresolvable.
template_name	string	The pinned template's display name; "" when the pin is unresolvable.
template_version	string	The pinned template version's label (the pair of template_version_id).
template_version_has_mintmodel	boolean	Whether the pinned version holds a MintModel; unset when the pin is unresolvable (the v1 template_version has_mintmodel conditional).
template_version_id	string	The pinned template version's row id and label.
template_version_state	string	The pinned version's state (initializing, ready, broken, …); "" when the pin is unresolvable (the v1 include=template_version list read's row detail).

AssetBackgroundTask

AssetBackgroundTask is one latest-background-task row of an asset (the v1 node_background_task include's fields the GUI consumes).

Field	Type	Meaning
actions_count	integer	How many actions the task produced.
created_at	timestamp	When the record was created.
created_by	string	Username of the creating identity.
error_message	string	The failure message; "" when none.
id	string	The record's identity.
request_number	integer	The task's request sequence number on its node.
status_code	string	The task's serialized status code (initialized, running, success, error, …).
task_type	string	The task family, e.g. "GenerateActionsRequest".
template_version_id	string	The template version the task ran against.
updated_at	timestamp	When the record was last updated.

AssetFilter

AssetFilter is the typed assets predicate vocabulary.

Field	Type	Meaning
archived	boolean	Keep only archived (true) or unarchived (false) assets; unset keeps both (the v1 filter[archived_eq] contract).

Related pages

• opschain docs resources/template — the template and version the asset pins.
• opschain docs resources/task — the background-task rows behind latest_background_tasks.
• opschain docs resources/environment — the usual parent node.
• opschain docs entitlements — the assets entitlement that gates creating asset nodes.