Activity

Included from Basic tier

An activity is one row of the merged activity feed — changes and workflow runs read as a single denormalised union (node background tasks join on an explicit opt-in). It is a read-only projection: rows appear and progress as their underlying runs do, and the row's id is the underlying change, workflow run or task id. The feed backs the GUI home screen and the CLI run listings. Served by the v2 ActivityService (ListActivities, plus ListWaitingGates for the caller's own approval queue); it is PostgreSQL-backed and answers unimplemented under the embedded store.

Activity

Activity is one row of the merged feed: the denormalised columns both arms share, typed.

Field	Type	Meaning
action	string	The feed's action column; empty when the row has none.
activity_type	ActivityType	Which arm the row comes from: change, workflow run or node background task (vocabulary below).
commit_sha	string	The change's resolved git commit sha; empty on workflow_run and task rows.
created_at	timestamp	When the record was created.
created_by	string	Username of the creating identity.
error_message	string	The task's failure message — a node-background-task field, set only on task rows.
finished_at	timestamp	When the run finished; unset while it is still in flight.
git_remote_name	string	The change's git identity; empty on workflow_run and task rows (and on changes carrying none).
git_rev	string	The change's requested git revision (branch, tag or sha); empty on workflow_run and task rows.
id	string	The underlying change or workflow run id.
metadata_json	string	The row's metadata document as JSON text ("" on task rows).
node_path	string	The target node's path.
parents	array of ActivityParent	The target node's parent trail, root first — ACTIVITY_VIEW_WITH_PARENTS only.
pause_state	string	pausing while a paused run's active steps are still finishing, paused once fully held, none when the run is not paused.
paused	boolean	Whether the run is currently paused.
paused_by_json	string	The pause/resume trail as JSON text ("" on task rows, "[]" when never paused).
project_name	string	The owning project's display name.
request_number	integer	The task's request number — a node-background-task field, set only on task rows.
scheduled	boolean	Whether a scheduled activity spawned the run.
started_at	timestamp	When the run started executing; unset while queued.
status_code	string	The run's serialized status code (queued, running, waiting, success, error, cancelled, …).
task_type	string	Node-background-task fields; set only on ACTIVITY_TYPE_NODE_BACKGROUND_TASK rows, whose id is the task id (the ReadLogLines/NBT handle).
updated_at	timestamp	When the record was last updated.
workflow_code	string	The workflow's code; empty on change rows.
workflow_name	string	The workflow's display name; empty on change rows.
workflow_version	integer	The workflow version number the run executes; 0 on change and task rows.

ActivityParent

ActivityParent is one node of a row's parent trail: the v1 parents entry, typed. Template fields are empty when the node is untemplated.

Field	Type	Meaning
code	string	The record's code.
id	string	The record's identity.
kind	string	"project" | "environment" | "asset" | …
name	string	Display name.
node_path	string	The parent node's canonical path.
template_code	string	The template backing the node; empty when the node is untemplated.
template_name	string	The backing template's display name; empty when untemplated.
template_version	string	The node's active template version label; empty when untemplated.

ActivityFilter

ActivityFilter is the typed activity vocabulary. All fields combine with AND (node_scopes internally any-of); empty fields do not restrict.

Field	Type	Meaning
action	string	Exact action to keep (the dashboard drill-down contract); a row with no action never matches.
action_present	boolean	Keep only rows whose action is present (drops approval-root changes the way the GUI feed does).
activity_type	ActivityType	Restrict the union to one arm (vocabulary below); unspecified keeps both standing arms.
commit_sha	string	Exact commit sha to keep (the dashboard hot-commits drill-down); excludes every workflow_run row.
created_after	timestamp	Keep rows created strictly after this instant.
created_before	timestamp	Keep rows created strictly before this instant.
created_by	array of string	Creating usernames to keep — any-of (the GUI user picker).
finished_after	timestamp	Keep rows finished strictly after this instant; a row with no finished_at matches no bound.
finished_before	timestamp	Keep rows finished strictly before this instant; a row with no finished_at matches no bound.
free_text	array of string	Free-text search terms: a row matches when any term matches any of the feed's searchable fields (id, project, action, creator, git identity, status, metadata), case-insensitively.
git_remote_name_contains	string	Case-insensitive substring over the change arm's git identity (the v1 git_remote_name_cont/git_rev_cont ILIKE predicates); either excludes every workflow_run row, whose columns are NULL.
git_rev_contains	string	Case-insensitive substring over the change arm's requested git revision (the same contract as git_remote_name_contains); excludes every workflow_run row.
ids	array of string	Exact activity ids to keep — any-of (the GUI's uuid lookup and the batched parent-trail hydration).
include_background_tasks	boolean	Also include node background tasks (actions refreshes) in the union — the "show background tasks" opt-in, default off: unset, the feed is exactly the change/workflow_run union of today.
metadata_contains	string	Case-insensitive substring over the row's metadata document rendered as text (the v1 metadata_text_cont ransacker).
node_scopes	array of NodeScope	Target-node scopes, any-of.
paused	boolean	Keep only paused (true) or unpaused (false) rows.
project_codes	array of string	Project codes to keep — any-of.
scheduled	boolean	Keep only scheduled (true) or unscheduled (false) rows.
scheduled_activity_id	string	The spawning scheduled activity's id (exact, case-insensitive — the v1 uuid-cast _eq: an unparseable value matches nothing).
started_after	timestamp	Keep rows started strictly after this instant; a row with no started_at matches no bound.
started_before	timestamp	Keep rows started strictly before this instant; a row with no started_at matches no bound.
status_codes	array of string	Serialized status codes to keep — any-of.
updated_after	timestamp	Strict root-step timestamp windows (the v1 _gt/_lt bounds): a row with no such timestamp (SQL NULL) matches no bound.
updated_before	timestamp	Keep rows updated strictly before this instant (the same strict-bound semantics as updated_after).
workflow_code	string	The workflow's code (exact; excludes every change row).
workflow_versions	array of integer	Workflow version numbers to keep — any-of (the v1 version_in set); excludes every change row, whose version is NULL.

ActivityOrder

ActivityOrder selects the feed's sort column (always descending).

Values: ACTIVITY_ORDER_UNSPECIFIED, ACTIVITY_ORDER_UPDATED_AT, ACTIVITY_ORDER_CREATED_AT.

ActivityOutcome

ActivityOutcome is the dashboard's outcome rollup vocabulary over the serialized status codes.

Values: ACTIVITY_OUTCOME_UNSPECIFIED, ACTIVITY_OUTCOME_SUCCEEDED, ACTIVITY_OUTCOME_FAILED, ACTIVITY_OUTCOME_CANCELLED, ACTIVITY_OUTCOME_IN_PROGRESS, ACTIVITY_OUTCOME_OTHER.

ActivityType

ActivityType restricts the union to one arm.

Values: ACTIVITY_TYPE_UNSPECIFIED, ACTIVITY_TYPE_CHANGE, ACTIVITY_TYPE_WORKFLOW_RUN, ACTIVITY_TYPE_NODE_BACKGROUND_TASK.

ActivityView

ActivityView selects how much of each row ListActivities resolves (named views, never field masks).

Values: ACTIVITY_VIEW_UNSPECIFIED, ACTIVITY_VIEW_BASIC, ACTIVITY_VIEW_WITH_PARENTS.

Related pages

• opschain docs resources/change — the change arm's full row.
• opschain docs resources/workflow_run — the workflow-run arm's full row.
• opschain docs resources/task — the node-background-task arm's row.
• opschain docs events — the event stream the pause/resume trail is built from.