Skip to content

Assemblies

Assemblies are reusable automation records. Borealis uses them for quick jobs, scheduled jobs, workflow nodes, watchdog remediation, and Engine-side playbook execution.

Borealis Assembly List
Assembly List is the catalog for script assemblies, playbooks, and workflow-backed automation.

Use Assembly Catalog

Open Automation > Assemblies.

The catalog contains:

  • Script assemblies.
  • Workflow assemblies.
  • Ansible playbook assemblies.
  • Official Aurora assemblies.
  • Local user-created assemblies.

Understand Domains

  • Aurora / official assemblies come from the Aurora content repository.
  • User assemblies are created locally on your Engine.
  • Protected domains require admin/dev-mode workflows before direct edits.

Choose Assembly Type

Update Official Content

Use official update actions when you want the Engine to sync newer Aurora catalog content. Local user assemblies remain local.

Detailed Codex Breakdown

API endpoints

  • GET /api/assemblies - list assemblies.
  • GET /api/assemblies/<assembly_guid> - assembly details.
  • POST /api/assemblies - create assembly.
  • PUT /api/assemblies/<assembly_guid> - update assembly.
  • DELETE /api/assemblies/<assembly_guid> - delete assembly.
  • POST /api/assemblies/<assembly_guid>/clone - clone assembly.
  • POST /api/assemblies/import - import assembly JSON.
  • GET /api/assemblies/<assembly_guid>/export - export assembly JSON.
  • POST /api/assemblies/<assembly_guid>/official-update - update one official assembly.
  • POST /api/assemblies/official/update-all - sync official Aurora assemblies.

Source map

  • Assembly APIs: Data/Engine/Containers/api-backend/cmd/api-backend/assemblies.go and assemblies_catalog.go
  • Quick-run API: Data/Engine/Containers/api-backend/cmd/api-backend/quick_run.go
  • Assembly PostgreSQL store and schema: Data/Engine/Containers/api-backend/cmd/api-backend/assemblies.go and assemblies_schema.go
  • UI: Data/Engine/Containers/webui-frontend/data/web-interface/src/Assemblies/
  • Aurora cache: Engine/Services/api-backend/cache/Aurora/
  • Managed official catalog checkout: Engine/Services/api-backend/cache/Aurora/

Runtime behavior

  • Assembly tables live under PostgreSQL assemblies.*.
  • assembly_type routes records to script, workflow, or Ansible paths.
  • Official rows track Aurora provenance through source path, version, and content hash.
  • Go API reads bundled official assemblies and can sync Aurora when available. Retired Python Assembly cache, payload mirror, and catalog runtime no longer ship.