> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirurobotics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Releases

export const PublisherBadge = ({size = "md"}) => {
  return <Tooltip tip="Members with the publisher role can execute this action." cta="Workspace roles" href="/admin/users/access-control">
            <Badge icon="git-merge" color="green" size={size}>publisher</Badge>
        </Tooltip>;
};

export const AdminBadge = ({size = "md"}) => {
  return <Tooltip tip="Workspace owners and administrators can execute this action." cta="Workspace roles" href="/admin/users/access-control">
            <Badge icon="shield-check" color="blue" size={size}>admin</Badge>
        </Tooltip>;
};

export const PlatformApiLink = ({endpoint, newTab, children}) => {
  const href = `/references/platform-api/2026-05-06/endpoints/${endpoint}`;
  if (newTab) {
    return <a href={href} target="_blank" rel="noopener noreferrer">{children}</a>;
  }
  return <a href={href}>{children}</a>;
};

export const Framed = ({image, background, link, alt = "Framed content", borderWidth = "24px", outerRadius = "10px", innerRadius = "6px"}) => {
  const parseShorthand = value => {
    const values = String(value).trim().split(/\s+/);
    switch (values.length) {
      case 1:
        return [values[0], values[0], values[0], values[0]];
      case 2:
        return [values[0], values[1], values[0], values[1]];
      case 3:
        return [values[0], values[1], values[2], values[1]];
      default:
        return values.slice(0, 4);
    }
  };
  const isZero = v => parseFloat(v) === 0;
  const padding = parseShorthand(borderWidth);
  const outer = parseShorthand(outerRadius);
  const cornerMasks = [];
  if (isZero(padding[0]) && isZero(padding[3])) {
    cornerMasks.push(`radial-gradient(circle at 0% 0%, transparent ${outer[0]}, black ${outer[0]})`);
  }
  if (isZero(padding[0]) && isZero(padding[1])) {
    cornerMasks.push(`radial-gradient(circle at 100% 0%, transparent ${outer[1]}, black ${outer[1]})`);
  }
  if (isZero(padding[2]) && isZero(padding[1])) {
    cornerMasks.push(`radial-gradient(circle at 100% 100%, transparent ${outer[2]}, black ${outer[2]})`);
  }
  if (isZero(padding[2]) && isZero(padding[3])) {
    cornerMasks.push(`radial-gradient(circle at 0% 100%, transparent ${outer[3]}, black ${outer[3]})`);
  }
  const backgroundMask = cornerMasks.length > 0 ? cornerMasks.join(", ") : undefined;
  const innerImage = <img src={image} alt={alt} noZoom={link ? true : false} style={{
    display: "block",
    width: "100%",
    margin: 0,
    borderRadius: 0
  }} />;
  return <div style={{
    display: "inline-block",
    position: "relative",
    borderRadius: outerRadius,
    overflow: "hidden"
  }}>
            {}
            {background && <div style={{
    position: "absolute",
    inset: 0,
    backgroundImage: `url(${background})`,
    backgroundSize: "cover",
    maskImage: backgroundMask,
    WebkitMaskImage: backgroundMask,
    maskComposite: "intersect",
    WebkitMaskComposite: "source-in"
  }} />}
            {}
            <div style={{
    position: "relative",
    padding: borderWidth
  }}>
                <div style={{
    borderRadius: innerRadius,
    overflow: "hidden",
    lineHeight: 0
  }}>
                    {link ? <a href={link}>{innerImage}</a> : innerImage}
                </div>
            </div>
        </div>;
};

export const ImmutableBadge = ({size = "sm"}) => {
  return <Tooltip tip="Property cannot be modified">
            <Badge icon="lock" color="gray" size={size}>immutable</Badge>
        </Tooltip>;
};

<Framed background="https://assets.mirurobotics.com/docs/v04/images/releases/background.jpeg" image="https://assets.mirurobotics.com/docs/v04/images/releases/header:page.png" borderWidth="36px 0 0 56px" innerRadius="8px 0 0 0" />

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:

| **Config Type** | **Schema Version** |
| --------------- | ------------------ |
| `Mobility`      | **SCH-FmoDN**      |
| `Perception`    | **SCH-3JcLq**      |
| `Manipulation`  | **SCH-HHDRn**      |

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

<ParamField path="version" type="string">
  <ImmutableBadge />

  A [semantic version](https://semver.org/), 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`
</ParamField>

<ParamField path="config schemas" type="[] Config Schema">
  <ImmutableBadge />

  The [config schemas](/cfg-mgmt/primitives/schemas/overview#properties) that define compatible config instances for the release.

  Examples: `SCH-FmoDN`, `SCH-3JcLq`, `SCH-HHDRn`
</ParamField>

<ParamField path="upload rules" type="[] Upload Rule">
  <ImmutableBadge />

  The [upload rules](/data-uploads/primitives/upload-rules#properties) that are part of this release.

  Examples: `UPR-FmoDN`, `UPR-3JcLq`, `UPR-HHDRn`
</ParamField>

## 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.

<Frame>
  ![Release Overview](https://assets.mirurobotics.com/docs/v04/images/releases/overview.png)
</Frame>

**Platform API**

To retrieve a release programmatically, use the <PlatformApiLink endpoint="releases/get">get release endpoint »</PlatformApiLink>

## Create a release  <PublisherBadge />

To create a release, visit the config management [create a release](/cfg-mgmt/create-a-release) guide.

If you want to add [upload rules](/data-uploads/primitives/upload-rules) to your release, visit the data uploads [create a release](/data-uploads/define-upload-rules) guide.

## Duplicate a release  <PublisherBadge />

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**.

<Frame>
  ![Release Ellipses Dropdown](https://assets.mirurobotics.com/docs/v04/images/releases/ellipses-dropdown.png)
</Frame>

A dialog will appear—input the new version name and hit **Create**.

<Frame>
  ![Duplicate Release Dialog](https://assets.mirurobotics.com/docs/v04/images/releases/duplicate-dialog.png)
</Frame>

## Delete a release  <AdminBadge />

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**.

<Frame>
  ![Release Ellipses Dropdown](https://assets.mirurobotics.com/docs/v04/images/releases/ellipses-dropdown.png)
</Frame>

A confirmation dialog will appear. Hit **Delete** to confirm the deletion.

<Frame>
  ![Delete Release Dialog](https://assets.mirurobotics.com/docs/v04/images/releases/delete-dialog.png)
</Frame>