Skip to main content
A release is a version of software and its compatible config schemas. Within a fleet of robots, multiple software versions may be deployed—each release defines which config schemas are valid for that version. For example, software release v1.7.0 might specify the following schemas: Before deploying config instances to a device, the deployment’s release (v1.7.0) is used to verify that all required config instances are present and that each instance complies with the release’s schemas.

Properties

version
string
A semantic version, unique for a given release.Versions must be dot-separated integers. You may optionally use a v prefix, a prerelease suffix (e.g. -alpha.X, -beta.X, -rc.X), or a build suffix (e.g. +build-metadata).Examples: v1, 1, v2.1, 2.1, v3.2.1, 3.2.1, v4.3.2-beta.1, 4.3.2-rc.1, v5.4.3+metadata, 6.5.4-beta.2+metadata
config schemas
[] Config Schema
The config schemas that define compatible config instances for the release.Examples: SCH-FmoDN, SCH-3JcLq, SCH-HHDRn
upload rules
[] Upload Rule
The upload rules that are part of this release.Examples: UPR-FmoDN, UPR-3JcLq, UPR-HHDRn

View a release

Dashboard To view a release and its schemas, click into the release from the releases page and switch to the Overview tab at the top.
Release Overview
Platform API To retrieve a release programmatically, use the

Create a release

To create a release, visit the config management create a release guide. If you want to add upload rules to your release, visit the data uploads create a release guide.

Duplicate a release

Duplicating a release creates a new release with the same config schemas and git information as the original. Of course, since releases require a unique version, the duplicated release must have a different version from the original release. Duplicating a release does not duplicate the release’s deployments—only the release, its schemas, and git information are duplicated. To duplicate a release, click the ellipses (…) on the release you want to duplicate and select Duplicate.
Release Ellipses Dropdown
A dialog will appear—input the new version name and hit Create.
Duplicate Release Dialog

Delete a release

Deleting a release is only possible if no deployments have been delivered to any device with that release. Otherwise, the release cannot be deleted. To delete a release, click the ellipses (…) on the release you want to delete and hit Delete.
Release Ellipses Dropdown
A confirmation dialog will appear. Hit Delete to confirm the deletion.
Delete Release Dialog
Last modified on July 21, 2026