FlexMeasures CLI Changelog

since v1.0.0 | August 11, 2026

flexmeasures add user --roles now parses comma-separated role lists and accepts repeated --roles options.
flexmeasures db upgrade now runs VACUUM ANALYZE after upgrading (refreshing the query planner’s statistics); opt out with --no-vacuum.
Add flexmeasures add plan, flexmeasures show plans and flexmeasures edit plan, to manage the rate limits and quotas which apply to the accounts on a plan.
Add flexmeasures edit secret to store an encrypted secret on an account or asset.
Add flexmeasures delete secret to remove an encrypted secret from an account or asset.
Add flexmeasures add automation, flexmeasures edit automation and flexmeasures delete automation to manage automations (recurring tasks on an asset, computing forecasts or schedules). Each automation carries its own IANA timezone (--timezone), in which its cron expression is interpreted.
Add flexmeasures jobs run-automations to queue jobs for all automations that are due to run this minute from standard five-field cron expressions. Run this command once per minute. It makes at most one queueing attempt per automation per minute, including when an attempt fails after partially queueing jobs. Runs missed while the runner was down are caught up once, with several missed forecast runs coalesced into the latest useful forecast, and a run at a skipped or repeated daylight-saving-time hour happens exactly once.
flexmeasures delete sensor now warns which automations read from or write to a sensor before it is deleted, as an automation refers to its sensors by ID and would fail on its next run.
flexmeasures show data-sources now shows the account a data source belongs to, and lists the sensors holding data recorded by a single source with --show-sensors.

since v0.33.0 | June 01, 2026

Add flexmeasures jobs inspect-job to show the job status and metadata information.

since v0.31.1 | March 6, 2026

Fix CLI command flexmeasures add forecasts in exchange for less detailed type annotations on various CLI options (visible when using the --help flag).

since v0.31.0 | February 28, 2026

Fix delete-beliefs CLI command ignoring the --source filter during deletion, preventing unintended removal of beliefs from other sources.
Allow flexmeasures add schedule to create schedules with only information known prior to some time using the prior option.
New --dry-run flag for flexmeasures add schedule to avoid saving anything (printing out the results instead).
Streamlines option names for flexmeasures add forecasts with API usage (preserving backwards compatibility).
Return validation errors instead of database errors for fields that map to database objects.
Mutate job state when running flexmeasures jobs run-job <job ID>, including updating metadata and moving between registries
Rename flexmeasures add sources to flexmeasures add sources-for-generators to better reflect its purpose.
Add flexmeasures jobs stats, which shows queueing statistics to help evaluate the health of the queueing system.

since v0.30.3 | January 12, 2026

Fix delete-beliefs CLI command ignoring the --source filter during deletion, preventing unintended removal of beliefs from other sources.

since v0.30.0 | December 02, 2025

Major overhaul of flexmeasures add forecasts (use the --help option to learn more).
Fix the interpretation of --start-offset and --end-offset options in flexmeasures add report, which was not using the correct time at which the command was run; instead, that time was off by and offset corresponding to the offset between the FLEXMEASURES_TIMEZONE config setting and UTC).
Add –force option to flexmeasures delete beliefs
The flexmeasures delete beliefs, flexmeasures delete nan-beliefs and flexmeasures delete unchanged-beliefs CLI commands now support limiting the action to a given set of data sources.
Allow asset-level scheduling in flexmeasures add schedule using the --asset option.
Allow modifying asset trees with the CLI using flexmeasures edit transfer-parenthood.
flexmeasures show asset will now also display the flex model.

since v0.29.0 | October 14, 2025

Include finished and canceled jobs in the overview printed by the CLI command flexmeasures jobs show-queues.
The flexmeasures delete unchanged-beliefs CLI command now supports limiting the action to a given period.

since v0.28.0 | September 10, 2025

Removed command flexmeasures db-ops save and flexmeasures db-ops load for folder&file - base backup management.

since v0.27.0 | July 20, 2025

Add flexmeasures show assets CLI command for listing public assets and option --account <account-id> to list assets owned by a specific account.

since v0.26.0 | June 03, 2025

Switch to flexmeasures jobs save-last CLI command for saving the last n canceled/deferred/failed/finished/scheduled/started jobs (from the scheduling queue, by default).
Add flexmeasures show assets CLI command for listing public assets and option --account <account-id> to list assets owned by a specific account.

since v0.25.0 | April 01, 2025

Report parameters set using flexmeasures add report --parameters can use any argument supported by Sensor.search_beliefs to allow more control over input for the report.
Add flexmeasures jobs save-last-failed (since v0.26: flexmeasures jobs save-last) CLI command for saving the last n failed jobs (from the scheduling queue, by default).
Add flexmeasures jobs delete-queue CLI command for deleting an obsolete queue.

since v0.24.0 | January 6, 2025

flexmeasures show beliefs shows datetime values on x-axis labels.
flexmeasures add sensor no longer requires the capacity_in_mw attribute to be set for power sensors.

since v0.22.0 | June 29, 2024

Add --resolution option to flexmeasures show chart to produce charts in different time resolutions.

since v0.21.0 | April 16, 2024

Include started, deferred and scheduled jobs in the overview printed by the CLI command flexmeasures jobs show-queues.

since v.0.20.0 | March 26, 2024

Add command flexmeasures edit transfer-ownership to transfer the ownership of an asset and its children.
Add --offspring option to flexmeasures delete beliefs command, allowing to delete beliefs of children, as well.
Add support for providing a sensor definition to the --site-power-capacity, --site-consumption-capacity and --site-production-capacity options of the flexmeasures add schedule for-storage command.

since v0.19.1 | February 26, 2024

Fix support for providing a sensor definition to the --storage-power-capacity option of the flexmeasures add schedule for-storage command.

since v0.19.0 | February 18, 2024

Enable the use of QuantityOrSensor fields for the flexmeasures add schedule for-storage CLI command:
- charging-efficiency
- discharging-efficiency
- soc-gain
- soc-usage
- power-capacity
- production-capacity
- consumption-capacity
- storage-efficiency
Streamline CLI option naming by favoring --<entity> over --<entity>-id. This affects the following options:
- --account-id -> --account
- --asset-id -> --asset
- --asset-type-id -> --asset-type
- --sensor-id -> --sensor
- --source-id -> --source
- --user-id -> --user

since v0.18.1 | January 15, 2024

Fix the validation of the option --parent-asset of command flexmeasures add asset.

since v0.17.0 | November 8, 2023

Add --consultancy option to flexmeasures add account to create a consultancy relationship with another account.

since v0.16.0 | September 29, 2023

Add command flexmeasures add sources to add the base DataSources for the DataGenerators.
Add command flexmeasures show chart to export sensor and asset charts in PNG or SVG formats.
Add --kind reporter option to flexmeasures add toy-account to create the asset and sensors for the reporter tutorial.
Add --id option to flexmeasures show data-sources to show just one DataSource.
Add --show-attributes flag to flexmeasures show data-sources to select whether to show the attributes field or not.

since v0.15.0 | August 9, 2023

Allow deleting multiple sensors with a single call to flexmeasures delete sensor by passing the --id option multiple times.
Add flexmeasures add schedule to create a new process schedule for a given power sensor. Make sure to use the --scheduler ProcessScheduler option to use the in-built process scheduler.
Add support for describing config and parameters in YAML for the command flexmeasures add report, editable in user’s code editor using the flags --edit-config or --edit-parameters.
Add --kind process option to create the asset and sensors for the ProcessScheduler tutorial.

since v0.14.1 | June 20, 2023

Avoid saving any NaN values to the database, when calling flexmeasures add report.
Fix defaults for the --start-offset and --end-offset` options to ``flexmeasures add report, which weren’t being interpreted in the local timezone of the reporting sensor.

since v0.14.0 | June 15, 2023

Allow setting a storage efficiency using the new --storage-efficiency option to the flexmeasures add schedule for-storage CLI command.
Add CLI command flexmeasures add report to calculate a custom report from sensor data and save the results to the database, with the option to export them to a CSV or Excel file.
Add CLI command flexmeasures show reporters to list available reporters, including any defined in registered plugins.
Add CLI command flexmeasures show schedulers to list available schedulers, including any defined in registered plugins.
Make --account-id optional in flexmeasures add asset to support creating public assets, which are available to all users.

since v0.13.0 | May 1, 2023

Add flexmeasures add source CLI command for adding a new data source.
Add --inflexible-device-sensor option to flexmeasures add schedule.

since v0.12.0 | January 04, 2023

Add --resolution, --timezone and --to-file options to flexmeasures show beliefs, to show beliefs data in a custom resolution and/or timezone, and also to save shown beliefs data to a CSV file.
Add options to flexmeasures add beliefs to 1) read CSV data with timezone naive datetimes (use --timezone to localize the data), 2) read CSV data with datetime/timedelta units (use --unit datetime or --unit timedelta, 3) remove rows with NaN values, and 4) add filter to read-in data by matching values in specific columns (use --filter-column and --filter-value together).
Fix flexmeasures db-ops dump and flexmeasures db-ops restore incorrectly reporting a success when pg_dump and pg_restore are not installed.
Add flexmeasures monitor last-seen.
Rename flexmeasures monitor tasks to flexmeasures monitor last-run.
Rename flexmeasures add schedule to flexmeasures add schedule for-storage (in expectation of more scheduling commands, based on in-built flex models).

since v0.11.0 | August 28, 2022

Add flexmeasures jobs show-queues to show contents of computation job queues.
--name parameter in flexmeasures jobs run-worker is now optional.
Add --custom-message param to flexmeasures monitor tasks.
Rename -optimization-context-id to --consumption-price-sensor in flexmeasures add schedule, and added --production-price-sensor.

since v0.9.0 | March 25, 2022

Add CLI commands for showing data flexmeasures show accounts, flexmeasures show account, flexmeasures show roles, flexmeasures show asset-types, flexmeasures show asset, flexmeasures show data-sources, and flexmeasures show beliefs.
Add flexmeasures db-ops resample-data CLI command to resample sensor data to a different resolution.
Add flexmeasures edit attribute CLI command to edit/add an attribute on an asset or sensor.
Add flexmeasures add toy-account for tutorials and trying things.
Add flexmeasures add schedule to create a new schedule for a given power sensor.
Add flexmeasures delete asset to delete an asset (including its sensors and data).
Rename flexmeasures add structure to flexmeasures add initial-structure.

since v0.8.0 | January 26, 2022

Add flexmeasures add sensor, flexmeasures add asset-type, `flexmeasures add beliefs. These were previously experimental features (under the dev-add command group).
flexmeasures add asset now directly creates an asset in the new data model.
Add flexmeasures delete sensor, flexmeasures delete nan-beliefs and flexmeasures delete unchanged-beliefs.

since v0.6.0 | April 2, 2021

Add flexmeasures add account, flexmeasures delete account, and the --account-id param to flexmeasures add user.

since v0.4.0 | April 2, 2021

Add the dev-add command group for experimental features around the upcoming data model refactoring.

since v0.3.0 | April 2, 2021

Refactor CLI into the main groups add, delete, jobs and db-ops
Add flexmeasures add asset, flexmeasures add user and flexmeasures add weather-sensor
Split the populate-db command into flexmeasures add structure and flexmeasures add forecasts