Skip to main content
Version: v5.7.0

Project

Included from Basic tier

A project is the top of an estate subtree ("/projects/web"): environments, assets, workflows, triggers and git remotes all live beneath one, and its owned properties and settings documents seed the merge for everything under it. Every project holds environments, project-level assets and entities (the former Standard/Enterprise project_type is retired: the attribute is still accepted on create and update and ignored, and it no longer appears in responses; the licence assets feature and limit are the only gate on asset creation). Update semantics preserve unset fields and toggle archive/restore; delete soft-deletes the subtree. Served by the v2 ProjectService (ListProjects, GetProject, CreateProject, UpdateProject, DeleteProject).

Project​

Project is the typed project read shape: the v1 node serializer's project attributes plus the owned-document ids and the per-node authorisation summary the GUI consumes.

FieldTypeMeaning
archivedbooleanWhether the project is archived. Toggled through UpdateProject; a no-op toggle, or archiving while changes are active, refuses.
changes_executebooleanMay the caller execute changes under this node (execute on /changes — the v1 meta.authorisations.changes.execute).
codestringThe record's code.
created_bystringUsername of the creating identity.
descriptionstring"" when never set.
idstringThe record's identity.
maintenanceNodeMaintenanceBadgeThe active-maintenance badge; unset while the node is open (the v1 maintenance attribute).
namestringDisplay name.
node_pathstringThe project's node path, e.g. "/projects/web".
properties_idstringThe project's owned properties/settings document ids.
settings_idstringThe project's owned settings document id (the pair of properties_id).

ProjectFilter​

ProjectFilter is the typed projects predicate vocabulary. All fields combine with AND; unset fields do not restrict.

FieldTypeMeaning
archivedbooleanKeep only archived (true) or unarchived (false) projects; unset keeps both (the v1 filter[archived_eq] contract).
  • opschain docs resources/environment — the nodes beneath a project.
  • opschain docs resources/node — the generic hierarchy read the project row specialises.
  • opschain docs resources/settings — the owned settings document and its merge.