balena-cli 25.0.0 → 25.1.0

package/CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file
 automatically by Versionist. DO NOT EDIT THIS FILE MANUALLY!
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 25.1.0 - 2026-04-28
+
+* Add organization management commands [Thodoris Greasidis]
+
 ## 25.0.0 - 2026-04-28
 
 * Update @balena/compose to v8, add @balena/compose-parser dependency [Christina Ying Wang]

package/build/commands/organization/create.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@oclif/core';
+export default class OrganizationCreateCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        orgName: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static authenticated: boolean;
+    run(): Promise<void>;
+}

package/build/commands/organization/create.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const lazy_1 = require("../../utils/lazy");
+class OrganizationCreateCmd extends core_1.Command {
+    async run() {
+        const { args: params } = await this.parse(OrganizationCreateCmd);
+        const balena = (0, lazy_1.getBalenaSdk)();
+        const org = await balena.models.organization.create({
+            name: params.orgName,
+        });
+        console.log((0, lazy_1.getVisuals)().table.vertical(org, ['id', 'name', 'handle', 'created_at']));
+    }
+}
+OrganizationCreateCmd.description = (0, lazy_1.stripIndent) `
+		Create an organization.
+
+		Create a new organization.
+`;
+OrganizationCreateCmd.examples = ['$ balena organization create MyOrg'];
+OrganizationCreateCmd.args = {
+    orgName: core_1.Args.string({
+        description: 'the name to use for the new organization',
+        required: true,
+    }),
+};
+OrganizationCreateCmd.authenticated = true;
+exports.default = OrganizationCreateCmd;
+//# sourceMappingURL=create.js.map

package/build/commands/organization/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../../src/commands/organization/create.ts"],"names":[],"mappings":";;AAiBA,sCAA4C;AAC5C,2CAAyE;AAEzE,MAAqB,qBAAsB,SAAQ,cAAO;IAkBlD,KAAK,CAAC,GAAG;QACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,IAAA,mBAAY,GAAE,CAAC;QAC9B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;YACnD,IAAI,EAAE,MAAM,CAAC,OAAO;SACpB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CACV,IAAA,iBAAU,GAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC,CACxE,CAAC;IACH,CAAC;;AA5Ba,iCAAW,GAAG,IAAA,kBAAW,EAAA;;;;CAIvC,CAAC;AAEa,8BAAQ,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAElD,0BAAI,GAAG;IACpB,OAAO,EAAE,WAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,IAAI;KACd,CAAC;CACF,CAAC;AAEY,mCAAa,GAAG,IAAI,CAAC;kBAhBf,qBAAqB"}

package/build/commands/organization/rename.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@oclif/core';
+export default class OrganizationRenameCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        handle: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        newName: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static authenticated: boolean;
+    run(): Promise<void>;
+}

package/build/commands/organization/rename.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const lazy_1 = require("../../utils/lazy");
+class OrganizationRenameCmd extends core_1.Command {
+    async run() {
+        const { args: params } = await this.parse(OrganizationRenameCmd);
+        const balena = (0, lazy_1.getBalenaSdk)();
+        const newName = params.newName ||
+            (await (0, lazy_1.getCliForm)().ask({
+                message: 'How do you want to name this organization?',
+                type: 'input',
+            })) ||
+            '';
+        const org = await balena.models.organization.get(params.handle, {
+            $select: 'id',
+        });
+        await balena.pine.patch({
+            resource: 'organization',
+            id: org.id,
+            body: {
+                name: newName,
+            },
+        });
+    }
+}
+OrganizationRenameCmd.description = (0, lazy_1.stripIndent) `
+		Rename an organization.
+
+		Rename an organization.
+
+		Note, if the name is omitted, it will be prompted for interactively.
+		`;
+OrganizationRenameCmd.examples = [
+    '$ balena organization rename my_org_handle',
+    '$ balena organization rename my_org_handle "My New Org"',
+];
+OrganizationRenameCmd.args = {
+    handle: core_1.Args.string({
+        description: 'the handle of the organization to rename',
+        required: true,
+    }),
+    newName: core_1.Args.string({
+        description: 'the new name for the organization',
+    }),
+};
+OrganizationRenameCmd.authenticated = true;
+exports.default = OrganizationRenameCmd;
+//# sourceMappingURL=rename.js.map

package/build/commands/organization/rename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rename.js","sourceRoot":"","sources":["../../../src/commands/organization/rename.ts"],"names":[],"mappings":";;AAiBA,sCAA4C;AAC5C,2CAAyE;AAEzE,MAAqB,qBAAsB,SAAQ,cAAO;IAyBlD,KAAK,CAAC,GAAG;QACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,IAAA,mBAAY,GAAE,CAAC;QAE9B,MAAM,OAAO,GAEZ,MAAM,CAAC,OAAO;YACd,CAAC,MAAM,IAAA,iBAAU,GAAE,CAAC,GAAG,CAAC;gBACvB,OAAO,EAAE,4CAA4C;gBACrD,IAAI,EAAE,OAAO;aAEb,CAAC,CAAC;YACH,EAAE,CAAC;QAEJ,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE;YAC/D,OAAO,EAAE,IAAI;SACb,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;YACvB,QAAQ,EAAE,cAAc;YACxB,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,IAAI,EAAE;gBACL,IAAI,EAAE,OAAO;aACb;SACD,CAAC,CAAC;IACJ,CAAC;;AAjDa,iCAAW,GAAG,IAAA,kBAAW,EAAA;;;;;;GAMrC,CAAC;AACW,8BAAQ,GAAG;IACxB,4CAA4C;IAC5C,yDAAyD;CACzD,CAAC;AAEY,0BAAI,GAAG;IACpB,MAAM,EAAE,WAAI,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,IAAI;KACd,CAAC;IACF,OAAO,EAAE,WAAI,CAAC,MAAM,CAAC;QACpB,WAAW,EAAE,mCAAmC;KAChD,CAAC;CACF,CAAC;AAEY,mCAAa,GAAG,IAAI,CAAC;kBAvBf,qBAAqB"}

package/build/commands/organization/rm.d.ts

@@ -0,0 +1,13 @@
+import { Command } from '@oclif/core';
+export default class OrganizationRmCmd extends Command {
+    static description: string;
+    static examples: string[];
+    static args: {
+        handle: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static authenticated: boolean;
+    run(): Promise<void>;
+}

package/build/commands/organization/rm.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const cf = require("../../utils/common-flags");
+const lazy_1 = require("../../utils/lazy");
+class OrganizationRmCmd extends core_1.Command {
+    async run() {
+        const { args: params, flags: options } = await this.parse(OrganizationRmCmd);
+        const balena = (0, lazy_1.getBalenaSdk)();
+        const patterns = await Promise.resolve().then(() => require('../../utils/patterns'));
+        const org = await balena.models.organization.get(params.handle, {
+            $select: ['id', 'name'],
+        });
+        await patterns.confirm(options.yes, `Are you sure you want to delete organization '${org.name}' with handle '${params.handle}' ?`);
+        await balena.models.organization.remove(org.id);
+    }
+}
+OrganizationRmCmd.description = (0, lazy_1.stripIndent) `
+		Remove an organizations.
+
+		Remove an organizations from balena.
+
+		Note this command asks for confirmation interactively.
+		You can avoid this by passing the \`--yes\` option.
+		`;
+OrganizationRmCmd.examples = [
+    '$ balena organization rm my_org_handle',
+    '$ balena organization rm my_org_handle --yes',
+];
+OrganizationRmCmd.args = {
+    handle: core_1.Args.string({
+        description: 'the handle of the organization to delete',
+        required: true,
+    }),
+};
+OrganizationRmCmd.flags = {
+    yes: cf.yes(),
+};
+OrganizationRmCmd.authenticated = true;
+exports.default = OrganizationRmCmd;
+//# sourceMappingURL=rm.js.map

package/build/commands/organization/rm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rm.js","sourceRoot":"","sources":["../../../src/commands/organization/rm.ts"],"names":[],"mappings":";;AAiBA,sCAA4C;AAC5C,+CAA+C;AAC/C,2CAA6D;AAE7D,MAAqB,iBAAkB,SAAQ,cAAO;IA2B9C,KAAK,CAAC,GAAG;QACf,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GACrC,MAAM,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,IAAA,mBAAY,GAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,2CAAa,sBAAsB,EAAC,CAAC;QAGtD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE;YAC/D,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;QAEH,MAAM,QAAQ,CAAC,OAAO,CACrB,OAAO,CAAC,GAAG,EACX,iDAAiD,GAAG,CAAC,IAAI,kBAAkB,MAAM,CAAC,MAAM,KAAK,CAC7F,CAAC;QAEF,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;;AA5Ca,6BAAW,GAAG,IAAA,kBAAW,EAAA;;;;;;;GAOrC,CAAC;AACW,0BAAQ,GAAG;IACxB,wCAAwC;IACxC,8CAA8C;CAC9C,CAAC;AAEY,sBAAI,GAAG;IACpB,MAAM,EAAE,WAAI,CAAC,MAAM,CAAC;QACnB,WAAW,EAAE,0CAA0C;QACvD,QAAQ,EAAE,IAAI;KACd,CAAC;CACF,CAAC;AAEY,uBAAK,GAAG;IACrB,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE;CACb,CAAC;AAEY,+BAAa,GAAG,IAAI,CAAC;kBAzBf,iBAAiB"}

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "balena-cli",
-  "version": "25.0.0",
+  "version": "25.1.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "balena-cli",
-      "version": "25.0.0",
+      "version": "25.1.0",
       "hasInstallScript": true,
       "license": "Apache-2.0",
       "dependencies": {

package/oclif.manifest.json

@@ -3233,6 +3233,37 @@
         "index.js"
       ]
     },
+    "organization:create": {
+      "aliases": [],
+      "args": {
+        "orgName": {
+          "description": "the name to use for the new organization",
+          "name": "orgName",
+          "required": true
+        }
+      },
+      "description": "Create an organization.\n\nCreate a new organization.",
+      "examples": [
+        "$ balena organization create MyOrg"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "organization:create",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "organization",
+        "create.js"
+      ]
+    },
     "organization:list": {
       "aliases": [],
       "args": {},
@@ -3258,134 +3289,80 @@
         "list.js"
       ]
     },
-    "preload": {
+    "organization:rename": {
       "aliases": [],
       "args": {
-        "image": {
-          "description": "the image file path",
-          "name": "image",
+        "handle": {
+          "description": "the handle of the organization to rename",
+          "name": "handle",
           "required": true
+        },
+        "newName": {
+          "description": "the new name for the organization",
+          "name": "newName"
         }
       },
-      "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
+      "description": "Rename an organization.\n\nRename an organization.\n\nNote, if the name is omitted, it will be prompted for interactively.",
       "examples": [
-        "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
-        "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
-        "$ balena preload balena.img"
+        "$ balena organization rename my_org_handle",
+        "$ balena organization rename my_org_handle \"My New Org\""
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "organization:rename",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "organization",
+        "rename.js"
+      ]
+    },
+    "organization:rm": {
+      "aliases": [],
+      "args": {
+        "handle": {
+          "description": "the handle of the organization to delete",
+          "name": "handle",
+          "required": true
+        }
+      },
+      "description": "Remove an organizations.\n\nRemove an organizations from balena.\n\nNote this command asks for confirmation interactively.\nYou can avoid this by passing the `--yes` option.",
+      "examples": [
+        "$ balena organization rm my_org_handle",
+        "$ balena organization rm my_org_handle --yes"
       ],
       "flags": {
-        "fleet": {
-          "char": "f",
-          "description": "fleet name or slug (preferred)",
-          "name": "fleet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "commit": {
-          "char": "c",
-          "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
-          "name": "commit",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "splash-image": {
-          "char": "s",
-          "description": "path to a png image to replace the splash screen",
-          "name": "splash-image",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dont-check-arch": {
-          "description": "disable architecture compatibility check between image and fleet",
-          "name": "dont-check-arch",
+        "yes": {
+          "char": "y",
+          "description": "answer \"yes\" to all questions (non interactive use)",
+          "name": "yes",
           "allowNo": false,
           "type": "boolean"
-        },
-        "pin-device-to-release": {
-          "char": "p",
-          "description": "pin the preloaded device to the preloaded release on provision",
-          "name": "pin-device-to-release",
-          "allowNo": true,
-          "type": "boolean"
-        },
-        "additional-space": {
-          "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
-          "name": "additional-space",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "add-certificate": {
-          "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
-          "name": "add-certificate",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "docker": {
-          "char": "P",
-          "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
-          "name": "docker",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dockerHost": {
-          "char": "h",
-          "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
-          "name": "dockerHost",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "dockerPort": {
-          "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
-          "name": "dockerPort",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "ca": {
-          "description": "Docker host TLS certificate authority file",
-          "name": "ca",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "cert": {
-          "description": "Docker host TLS certificate file",
-          "name": "cert",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "key": {
-          "description": "Docker host TLS key file",
-          "name": "key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "preload",
+      "id": "organization:rm",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
       "authenticated": true,
-      "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "preload",
-        "index.js"
+        "organization",
+        "rm.js"
       ]
     },
     "os:configure": {
@@ -3903,186 +3880,134 @@
         "index.js"
       ]
     },
-    "release:finalize": {
-      "aliases": [],
-      "args": {
-        "commitOrId": {
-          "description": "the commit or ID of the release to finalize",
-          "name": "commitOrId",
-          "required": true
-        }
-      },
-      "description": "Finalize a release.\n\nFinalize a release. Releases can be \"draft\" or \"final\", and this command\nchanges a draft release into a final release. Draft releases can be created\nwith the `--draft` option of the `balena build` or `balena deploy`\ncommands.\n\nDraft releases are not automatically deployed to devices tracking the latest\nrelease. For a draft release to be deployed to a device, the device should be\nexplicity pinned to that release. Conversely, final releases may trigger immediate\ndeployment to unpinned devices (subject to a device's  polling period) and, for\nthis reason, final releases cannot be changed back to draft status.",
-      "examples": [
-        "$ balena release finalize a777f7345fe3d655c1c981aa642e5555",
-        "$ balena release finalize 1234567"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "release:finalize",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "release",
-        "finalize.js"
-      ]
-    },
-    "release": {
+    "preload": {
       "aliases": [],
       "args": {
-        "commitOrId": {
-          "description": "the commit or ID of the release to get information",
-          "name": "commitOrId",
+        "image": {
+          "description": "the image file path",
+          "name": "image",
           "required": true
         }
       },
-      "description": "Get info for a release.",
+      "description": "Preload a release on a disk image (or Edison zip archive).\n\nPreload a release (service images/containers) from a balena fleet, and optionally\na balenaOS splash screen, in a previously downloaded '.img' balenaOS image file\nin the local disk (a zip file is only accepted for the Intel Edison device type).\nAfter preloading, the balenaOS image file can be flashed to a device's SD card.\nWhen the device boots, it will not need to download the release, as it was\npreloaded. This is usually combined with release pinning\n(https://www.balena.io/docs/learn/deploy/release-strategy/release-policy/)\nto avoid the device downloading a newer release straight away, if available.\nCheck also the Preloading and Preregistering section of the balena CLI's advanced\nmasterclass document:\nhttps://www.balena.io/docs/learn/more/masterclasses/advanced-cli/#5-preloading-and-preregistering\n\nFleets may be specified by fleet name or slug. Fleet slugs are\nthe recommended option, as they are unique and unambiguous. Slugs can be\nlisted with the `balena fleet list` command. Note that slugs may change if the\nfleet is renamed. Fleet names are not unique and may result in  \"Fleet is\nambiguous\" errors at any time (even if it \"used to work in the past\"), for\nexample if the name clashes with a newly created public fleet, or with fleets\nfrom other balena accounts that you may be invited to join under any role.\nFor this reason, fleet names are especially discouraged in scripts (e.g. CI\nenvironments).\n\nNote that the this command requires Docker to be installed, as further detailed\nin the balena CLI's installation instructions:\nhttps://github.com/balena-io/balena-cli/blob/master/INSTALL.md\nThe `--dockerHost` and `--dockerPort` flags allow a remote Docker engine to\nbe used, however the image file must be accessible to the remote Docker engine\non the same path given on the command line. This is because Docker's bind mount\nfeature is used to \"share\" the image with a container that performs the preload.",
       "examples": [
-        "$ balena release a777f7345fe3d655c1c981aa642e5555",
-        "$ balena release 1234567"
+        "$ balena preload balena.img --fleet MyFleet --commit e1f2592fc6ee949e68756d4f4a48e49bff8d72a0",
+        "$ balena preload balena.img --fleet myorg/myfleet --splash-image image.png",
+        "$ balena preload balena.img"
       ],
       "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "composition": {
-          "char": "c",
-          "description": "Return the release composition",
-          "name": "composition",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "release",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "release",
-        "index.js"
-      ]
-    },
-    "release:invalidate": {
-      "aliases": [],
-      "args": {
-        "commitOrId": {
-          "description": "the commit or ID of the release to invalidate",
-          "name": "commitOrId",
-          "required": true
-        }
-      },
-      "description": "Invalidate a release.\n\nInvalidate a release.\n\nInvalid releases are not automatically deployed to devices tracking the latest\nrelease. For an invalid release to be deployed to a device, the device should be\nexplicity pinned to that release.",
-      "examples": [
-        "$ balena release invalidate a777f7345fe3d655c1c981aa642e5555",
-        "$ balena release invalidate 1234567"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "release:invalidate",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "release",
-        "invalidate.js"
-      ]
-    },
-    "release:list": {
-      "aliases": [],
-      "args": {
         "fleet": {
+          "char": "f",
           "description": "fleet name or slug (preferred)",
           "name": "fleet",
-          "required": true
-        }
-      },
-      "description": "List all releases of a fleet.\n\nList all releases of the given fleet.\n\nFleets may be specified by fleet name or slug. Slugs are recommended because\nthey are unique and unambiguous. Slugs can be listed with the `balena fleet list`\ncommand. Note that slugs may change if the fleet is renamed. Fleet names are\nnot unique and may result in \"Fleet is ambiguous\" errors at any time (even if\n\"it used to work in the past\"), for example if the name clashes with a newly\ncreated public/open fleet, or with fleets from other balena accounts that you\nmay be invited to join under any role.  For this reason, fleet names are\nespecially discouraged in scripts (e.g. CI environments).",
-      "examples": [
-        "$ balena release list myorg/myfleet"
-      ],
-      "flags": {
-        "json": {
-          "description": "Format output as json.",
-          "helpGroup": "GLOBAL",
-          "name": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "commit": {
+          "char": "c",
+          "description": "The commit hash of the release to preload. Use \"current\" to specify the current\nrelease (ignored if no appId is given). The current release is usually also the\nlatest, but can be pinned to a specific release. See:\nhttps://www.balena.io/docs/learn/deploy/release-strategy/release-policy/\nhttps://www.balena.io/docs/learn/more/masterclasses/fleet-management/#63-pin-using-the-api\nhttps://github.com/balena-io-examples/staged-releases",
+          "name": "commit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "splash-image": {
+          "char": "s",
+          "description": "path to a png image to replace the splash screen",
+          "name": "splash-image",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dont-check-arch": {
+          "description": "disable architecture compatibility check between image and fleet",
+          "name": "dont-check-arch",
           "allowNo": false,
           "type": "boolean"
+        },
+        "pin-device-to-release": {
+          "char": "p",
+          "description": "pin the preloaded device to the preloaded release on provision",
+          "name": "pin-device-to-release",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "additional-space": {
+          "description": "expand the image by this amount of bytes instead of automatically estimating the required amount",
+          "name": "additional-space",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "add-certificate": {
+          "description": "Add the given certificate (in PEM format) to /etc/ssl/certs in the preloading container.\nThe file name must end with '.crt' and must not be already contained in the preloader's\n/etc/ssl/certs folder.\nCan be repeated to add multiple certificates.",
+          "name": "add-certificate",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
+        "docker": {
+          "char": "P",
+          "description": "Path to a local docker socket (e.g. /var/run/docker.sock)",
+          "name": "docker",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dockerHost": {
+          "char": "h",
+          "description": "Docker daemon hostname or IP address (dev machine or balena device) ",
+          "name": "dockerHost",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "dockerPort": {
+          "description": "Docker daemon TCP port number (hint: 2375 for balena devices)",
+          "name": "dockerPort",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ca": {
+          "description": "Docker host TLS certificate authority file",
+          "name": "ca",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cert": {
+          "description": "Docker host TLS certificate file",
+          "name": "cert",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "key": {
+          "description": "Docker host TLS key file",
+          "name": "key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "release:list",
-      "pluginAlias": "balena-cli",
-      "pluginName": "balena-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": true,
-      "authenticated": true,
-      "isESM": false,
-      "relativePath": [
-        "build",
-        "commands",
-        "release",
-        "list.js"
-      ]
-    },
-    "release:validate": {
-      "aliases": [],
-      "args": {
-        "commitOrId": {
-          "description": "the commit or ID of the release to validate",
-          "name": "commitOrId",
-          "required": true
-        }
-      },
-      "description": "Validate a release.\n\nValidate a release.\n\nValid releases are automatically deployed to devices tracking the latest\nrelease if they are finalized.",
-      "examples": [
-        "$ balena release validate a777f7345fe3d655c1c981aa642e5555",
-        "$ balena release validate 1234567"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "release:validate",
+      "id": "preload",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
       "authenticated": true,
+      "primary": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "release",
-        "validate.js"
+        "preload",
+        "index.js"
       ]
     },
     "release-asset:delete": {
@@ -4300,6 +4225,188 @@
         "upload.js"
       ]
     },
+    "release:finalize": {
+      "aliases": [],
+      "args": {
+        "commitOrId": {
+          "description": "the commit or ID of the release to finalize",
+          "name": "commitOrId",
+          "required": true
+        }
+      },
+      "description": "Finalize a release.\n\nFinalize a release. Releases can be \"draft\" or \"final\", and this command\nchanges a draft release into a final release. Draft releases can be created\nwith the `--draft` option of the `balena build` or `balena deploy`\ncommands.\n\nDraft releases are not automatically deployed to devices tracking the latest\nrelease. For a draft release to be deployed to a device, the device should be\nexplicity pinned to that release. Conversely, final releases may trigger immediate\ndeployment to unpinned devices (subject to a device's  polling period) and, for\nthis reason, final releases cannot be changed back to draft status.",
+      "examples": [
+        "$ balena release finalize a777f7345fe3d655c1c981aa642e5555",
+        "$ balena release finalize 1234567"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "release:finalize",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "release",
+        "finalize.js"
+      ]
+    },
+    "release": {
+      "aliases": [],
+      "args": {
+        "commitOrId": {
+          "description": "the commit or ID of the release to get information",
+          "name": "commitOrId",
+          "required": true
+        }
+      },
+      "description": "Get info for a release.",
+      "examples": [
+        "$ balena release a777f7345fe3d655c1c981aa642e5555",
+        "$ balena release 1234567"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "composition": {
+          "char": "c",
+          "description": "Return the release composition",
+          "name": "composition",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "release",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "release",
+        "index.js"
+      ]
+    },
+    "release:invalidate": {
+      "aliases": [],
+      "args": {
+        "commitOrId": {
+          "description": "the commit or ID of the release to invalidate",
+          "name": "commitOrId",
+          "required": true
+        }
+      },
+      "description": "Invalidate a release.\n\nInvalidate a release.\n\nInvalid releases are not automatically deployed to devices tracking the latest\nrelease. For an invalid release to be deployed to a device, the device should be\nexplicity pinned to that release.",
+      "examples": [
+        "$ balena release invalidate a777f7345fe3d655c1c981aa642e5555",
+        "$ balena release invalidate 1234567"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "release:invalidate",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "release",
+        "invalidate.js"
+      ]
+    },
+    "release:list": {
+      "aliases": [],
+      "args": {
+        "fleet": {
+          "description": "fleet name or slug (preferred)",
+          "name": "fleet",
+          "required": true
+        }
+      },
+      "description": "List all releases of a fleet.\n\nList all releases of the given fleet.\n\nFleets may be specified by fleet name or slug. Slugs are recommended because\nthey are unique and unambiguous. Slugs can be listed with the `balena fleet list`\ncommand. Note that slugs may change if the fleet is renamed. Fleet names are\nnot unique and may result in \"Fleet is ambiguous\" errors at any time (even if\n\"it used to work in the past\"), for example if the name clashes with a newly\ncreated public/open fleet, or with fleets from other balena accounts that you\nmay be invited to join under any role.  For this reason, fleet names are\nespecially discouraged in scripts (e.g. CI environments).",
+      "examples": [
+        "$ balena release list myorg/myfleet"
+      ],
+      "flags": {
+        "json": {
+          "description": "Format output as json.",
+          "helpGroup": "GLOBAL",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "release:list",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": true,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "release",
+        "list.js"
+      ]
+    },
+    "release:validate": {
+      "aliases": [],
+      "args": {
+        "commitOrId": {
+          "description": "the commit or ID of the release to validate",
+          "name": "commitOrId",
+          "required": true
+        }
+      },
+      "description": "Validate a release.\n\nValidate a release.\n\nValid releases are automatically deployed to devices tracking the latest\nrelease if they are finalized.",
+      "examples": [
+        "$ balena release validate a777f7345fe3d655c1c981aa642e5555",
+        "$ balena release validate 1234567"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "release:validate",
+      "pluginAlias": "balena-cli",
+      "pluginName": "balena-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "authenticated": true,
+      "isESM": false,
+      "relativePath": [
+        "build",
+        "commands",
+        "release",
+        "validate.js"
+      ]
+    },
     "settings": {
       "aliases": [],
       "args": {},
@@ -4740,53 +4847,53 @@
         "set.js"
       ]
     },
-    "whoami": {
+    "util:available-drives": {
       "aliases": [],
       "args": {},
-      "description": "Display account information for current user.\n\nGet the username and email address of the currently logged in user.",
-      "examples": [
-        "$ balena whoami"
-      ],
+      "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "whoami",
+      "id": "util:available-drives",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "authenticated": true,
+      "offlineCompatible": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "whoami",
-        "index.js"
+        "util",
+        "available-drives.js"
       ]
     },
-    "util:available-drives": {
+    "whoami": {
       "aliases": [],
       "args": {},
-      "description": "List available drives.\n\nList available drives which are usable for writing an OS image to.\nDoes not list system drives.",
+      "description": "Display account information for current user.\n\nGet the username and email address of the currently logged in user.",
+      "examples": [
+        "$ balena whoami"
+      ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "util:available-drives",
+      "id": "whoami",
       "pluginAlias": "balena-cli",
       "pluginName": "balena-cli",
       "pluginType": "core",
       "strict": true,
       "enableJsonFlag": false,
-      "offlineCompatible": true,
+      "authenticated": true,
       "isESM": false,
       "relativePath": [
         "build",
         "commands",
-        "util",
-        "available-drives.js"
+        "whoami",
+        "index.js"
       ]
     }
   },
-  "version": "25.0.0"
+  "version": "25.1.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "balena-cli",
-  "version": "25.0.0",
+  "version": "25.1.0",
   "description": "The official balena Command Line Interface",
   "main": "./build/app.js",
   "homepage": "https://github.com/balena-io/balena-cli",
@@ -258,6 +258,6 @@
     }
   },
   "versionist": {
-    "publishedAt": "2026-04-28T13:25:32.369Z"
+    "publishedAt": "2026-04-28T19:52:11.170Z"
   }
 }

package/src/commands/organization/create.ts

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2016-2020 Balena Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Args, Command } from '@oclif/core';
+import { getBalenaSdk, getVisuals, stripIndent } from '../../utils/lazy';
+
+export default class OrganizationCreateCmd extends Command {
+	public static description = stripIndent`
+		Create an organization.
+
+		Create a new organization.
+`;
+
+	public static examples = ['$ balena organization create MyOrg'];
+
+	public static args = {
+		orgName: Args.string({
+			description: 'the name to use for the new organization',
+			required: true,
+		}),
+	};
+
+	public static authenticated = true;
+
+	public async run() {
+		const { args: params } = await this.parse(OrganizationCreateCmd);
+
+		const balena = getBalenaSdk();
+		const org = await balena.models.organization.create({
+			name: params.orgName,
+		});
+
+		console.log(
+			getVisuals().table.vertical(org, ['id', 'name', 'handle', 'created_at']),
+		);
+	}
+}

package/src/commands/organization/rename.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ * Copyright 2016-2020 Balena Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Args, Command } from '@oclif/core';
+import { getBalenaSdk, stripIndent, getCliForm } from '../../utils/lazy';
+
+export default class OrganizationRenameCmd extends Command {
+	public static description = stripIndent`
+		Rename an organization.
+
+		Rename an organization.
+
+		Note, if the name is omitted, it will be prompted for interactively.
+		`;
+	public static examples = [
+		'$ balena organization rename my_org_handle',
+		'$ balena organization rename my_org_handle "My New Org"',
+	];
+
+	public static args = {
+		handle: Args.string({
+			description: 'the handle of the organization to rename',
+			required: true,
+		}),
+		newName: Args.string({
+			description: 'the new name for the organization',
+		}),
+	};
+
+	public static authenticated = true;
+
+	public async run() {
+		const { args: params } = await this.parse(OrganizationRenameCmd);
+
+		const balena = getBalenaSdk();
+
+		const newName =
+			// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+			params.newName ||
+			(await getCliForm().ask({
+				message: 'How do you want to name this organization?',
+				type: 'input',
+				// eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing
+			})) ||
+			'';
+
+		const org = await balena.models.organization.get(params.handle, {
+			$select: 'id',
+		});
+		await balena.pine.patch({
+			resource: 'organization',
+			id: org.id,
+			body: {
+				name: newName,
+			},
+		});
+	}
+}

package/src/commands/organization/rm.ts

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2016-2020 Balena Ltd.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { Args, Command } from '@oclif/core';
+import * as cf from '../../utils/common-flags';
+import { getBalenaSdk, stripIndent } from '../../utils/lazy';
+
+export default class OrganizationRmCmd extends Command {
+	public static description = stripIndent`
+		Remove an organizations.
+
+		Remove an organizations from balena.
+
+		Note this command asks for confirmation interactively.
+		You can avoid this by passing the \`--yes\` option.
+		`;
+	public static examples = [
+		'$ balena organization rm my_org_handle',
+		'$ balena organization rm my_org_handle --yes',
+	];
+
+	public static args = {
+		handle: Args.string({
+			description: 'the handle of the organization to delete',
+			required: true,
+		}),
+	};
+
+	public static flags = {
+		yes: cf.yes(),
+	};
+
+	public static authenticated = true;
+
+	public async run() {
+		const { args: params, flags: options } =
+			await this.parse(OrganizationRmCmd);
+
+		const balena = getBalenaSdk();
+		const patterns = await import('../../utils/patterns');
+
+		// Confirm
+		const org = await balena.models.organization.get(params.handle, {
+			$select: ['id', 'name'],
+		});
+
+		await patterns.confirm(
+			options.yes,
+			`Are you sure you want to delete organization '${org.name}' with handle '${params.handle}' ?`,
+		);
+
+		await balena.models.organization.remove(org.id);
+	}
+}