Skip to main content
Early Access - The Dcycle CLI is currently available for enterprise customers. Contact us to learn more about access.

Overview

Waste water treatment records track water treatment processes and their associated greenhouse gas emissions. The CLI provides a recalculation command to trigger async emission calculations for records that don’t have computed values yet.

Available Commands

CommandDescription
dcy waste-water-treatments recalculateQueue recalculation for WWT records without emissions

Recalculate Emissions

Queue recalculation for waste water treatment records that don’t have calculated emissions yet. The backend sets each matched record to “loading” status and triggers async recalculation via EventBridge:
dcy waste-water-treatments recalculate --yes
Output:
done — 12 WWT record(s) queued for recalculation
If no records need recalculation:
no WWT records found without calculated emissions

Flags

FlagShortDefaultDescription
--facility-fFacility UUID (omit to recalculate all facilities in the org)
--yes-yfalseSkip confirmation prompt
--dry-runfalseShow what would be executed without triggering
--orgOrganization ID override

Examples

# Recalculate all facilities in the organization
dcy waste-water-treatments recalculate --yes

# Scope to a single facility
dcy waste-water-treatments recalculate --facility <facility-id> --yes

# Preview what would happen (no API calls)
dcy waste-water-treatments recalculate --dry-run

# JSON output
dcy waste-water-treatments recalculate --yes --format json
For large organizations, use --facility to scope the recalculation to a single facility to avoid long-running operations.

Typical Workflows

Recalculate After Data Changes

After updating waste water treatment data in the web interface, trigger recalculation from the CLI:
# Preview which facility to target
dcy facility list --format json | jq '.[] | {id, name}'

# Dry-run to see the scope
dcy waste-water-treatments recalculate --facility <facility-id> --dry-run

# Trigger recalculation
dcy waste-water-treatments recalculate --facility <facility-id> --yes

Next Steps

Facilities

Manage physical locations

Invoices

Manage energy invoices for Scope 1 and 2 emissions

Own Workforce

Manage own workforce records

Custom Emission Factors

Upload organization-specific emission factors