Query and manage decarbonization plans — reduction targets, planned actions, baseline emissions, and organizational scope perimeters. Plans define emission reduction strategies against a baseline year, with targets specifying scope-level reduction percentages and actions tracking the concrete initiatives to achieve them.
Some targets and actions include ai_rationale and supporting_sources fields — these are generated by Leia, Dcycle’s AI assistant, when it proposes targets or actions. Manually created items will have these fields as null.
Get baseline emissions data for a decarbonization plan — the actual carbon footprint numbers used as the starting point for reduction calculations.Parameters:
Create a reduction target within a decarbonization plan. Targets define a scope-level emission reduction goal between a base year and a target year.Parameters:
Parameter
Type
Required
Default
Description
plan_id
string
Yes
—
UUID of the decarbonization plan
base_year
integer
Yes
—
Baseline year for the target
target_year
integer
Yes
—
Year by which the reduction should be achieved
scope
list[int]
No
—
GHG scopes covered (values: 1, 2, 3)
target_type
string
No
—
absolute (total reduction) or intensity (per-unit reduction)
base_emissions
float
No
—
Baseline emissions in tCO2e for the target scopes
reduction_percentage
float
No
—
Target reduction (0–100), e.g. 42.0 = 42% reduction
organization_id
string
No
default org
Organization UUID
Example prompts:
"Create a 42% reduction target for scopes 1 and 2 by 2030, baseline year 2023""Add an intensity-based target to our decarb plan with 30% reduction by 2028""Set a new absolute target for scope 3 emissions — 25% reduction from 2024 to 2030"
The plan must already exist — use list_decarb_plans to find the plan_id first. If scope is not set, the API uses the plan’s default included scopes. When base_emissions is omitted, the API calculates it from actual emissions data for the given base year and scopes.
Create a decarbonization action linked to a reduction target. Actions are concrete initiatives (e.g. install solar panels, switch fleet to electric) that contribute to a target’s reduction goal.Parameters:
Parameter
Type
Required
Default
Description
plan_id
string
Yes
—
UUID of the decarbonization plan
title
string
Yes
—
Action title (max 255 chars)
target_id
string
Yes
—
UUID of the reduction target this action supports
description
string
No
—
Detailed description (max 5000 chars)
scope
list[int]
No
—
GHG scopes addressed (values: 1, 2, 3)
estimated_co2e_reduction
float
No
—
Estimated tCO2e saved per year
estimated_cost
float
No
—
Estimated implementation cost
payback_period_months
integer
No
—
Months until the investment pays back
priority
string
No
—
quick_win, medium_term, or long_term
initiative_type
string
No
—
heating, electricity, fleet, operational, suppliers, or other
launch_date
string
No
—
Planned start date (YYYY-MM-DD)
organization_id
string
No
default org
Organization UUID
Example prompts:
"Add an action to install 150kW solar panels at the Madrid warehouse, targeting scope 2, estimated 85 tCO2e reduction and €120k cost""Create a quick-win action to switch office lighting to LED under our 2030 target""Add a fleet electrification action with 72-month payback, launching June 2026"
The target must already exist — use list_decarb_targets to find the target_id. Actions are created with status proposed by default. Use the Dcycle UI to accept, reject, or update status.
Common errors:
Error
Cause
Fix
404 Not Found
Invalid plan_id or target_id
Verify with list_decarb_plans / list_decarb_targets
Get the organizational scope/perimeter snapshot for a decarbonization plan — which facilities, emission categories, and scopes are included.Parameters:
Structured artifact snapshot defining the plan perimeter (facilities, scopes, categories)
status
Artifact state: draft, needs_input, ready, or stale
is_stale
Whether the snapshot is outdated compared to current plan data
report_file_id
File ID of the generated PDF report (null if not yet generated)
Example prompts:
"List our decarbonization plans""What are the baseline emissions for our decarbonization plan?""What reduction targets do we have and are they on track?""Show all planned actions and their progress""Which actions have been approved by finance?""What's the estimated CO2 reduction from our solar panel initiative?""Which facilities are included in our decarbonization scope?"