Environment

Included from Basic tier

An environment is the estate node between a project and its assets — "/projects/web/environments/dev" — owning its own properties and settings documents that merge into everything beneath it. Create, update (archive/restore included) and soft-delete follow the node-write semantics: a field left unset preserves the stored value, and deleting hides the whole subtree reversibly. An environment also carries the agent governance attribute release_stage_floor — the release stage an agent must hold to act beneath it (opschain nodes update <path> --release-stage-floor <rung>). Served by the v2 EnvironmentService (ListEnvironments, GetEnvironment, CreateEnvironment, UpdateEnvironment, DeleteEnvironment).

Environment

Environment is the typed environment read shape.

Field	Type	Meaning
archived	boolean	Whether the environment is archived. Toggled through UpdateEnvironment; 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.
maintenance	NodeMaintenanceBadge	The active-maintenance badge; unset while the node is open (the v1 maintenance attribute).
name	string	Display name.
node_path	string	The environment's node path, e.g. "/projects/web/environments/dev".
project_code	string	The owning project's code.
properties_id	string	The environment's owned properties/settings document ids.
release_stage_floor	string	The agent release-stage floor: a rung of the estate's stage ladder, or "" for none. Set through UpdateEnvironment.release_stage_floor (needs packs:agent-governance; "" clears it; a name that is not a rung refuses). While set, every action, run and governed read an agent targets under this environment is refused with AGENT_RELEASE_STAGE_BELOW_FLOOR unless the agent's enrolled release sits at or above the rung — an agent without a release is always refused. See opschain docs agent-releases ("Where a stage may act").
settings_id	string	The environment's owned settings document id (the pair of properties_id).

EnvironmentFilter

EnvironmentFilter is the typed environments predicate vocabulary.

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

Related pages

• opschain docs resources/project — the owning node.
• opschain docs resources/asset — the templated nodes beneath it.
• opschain docs resources/properties — the owned documents and how they merge.
• opschain docs maintenance-windows — what the maintenance badge reports.
• opschain docs agent-releases — the stage ladder the release_stage_floor names and how the floor is enforced.