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.

An asset can be demoted to an entity (DemoteAsset, opschain asset demote) and an entity promoted to an asset (PromoteEntity): either conversion creates a new node with its own id and path and leaves the old one archived with its change history — an ordinary archived node that can be edited, unarchived, deleted and restored like any other. A promoted asset counts against the assets entitlement and limit like any created asset. See opschain docs resources/entity for the preconditions and the opschain_lineage entry.

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.
conversion_state	string	"promoted" or "demoted" on a node left behind by a conversion (left archived); "" otherwise. On an asset it is "demoted": the asset became the entity named by converted_to_path.
converted_from_id	string	The entity this asset was promoted from; "" when none.
converted_from_path	string	That entity's path; "" when none (or since destroyed).
converted_to_id	string	The entity this asset was demoted to; "" when none.
converted_to_path	string	That entity's path; "" when none (or since destroyed).
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.