From d1a429c19b3fdd7c0107b14eb70d7992aa197ee0 Mon Sep 17 00:00:00 2001
From: Alexander Mattoni <5110855+mattoni@users.noreply.github.com>
Date: Wed, 25 Feb 2026 11:04:00 +0000
Subject: [PATCH] Add stateless volume definition to local volumes.

---
 components/schemas/containers/config/ContainerVolume.yml | 9 +++++++++
 .../vms/config/volumes/VirtualMachineVolumeConfig.yml    | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/components/schemas/containers/config/ContainerVolume.yml b/components/schemas/containers/config/ContainerVolume.yml
index 0789ac6e..260cb936 100644
--- a/components/schemas/containers/config/ContainerVolume.yml
+++ b/components/schemas/containers/config/ContainerVolume.yml
@@ -27,6 +27,15 @@ properties:
           max_size:
             $ref: ../../DataSize.yml
             description: The maximum size this volume can grow to. Container volumes on Cycle are thinly provisioned, meaning this isn't an allocation - the volume will only use the space it needs up to this size.
+          stateless:
+            type: 
+              - boolean
+              - "null"
+            default: false
+            description: > 
+              If set to true, this volume will be treated as ephemeral. Stateless volumes will **NOT** be migrated.
+
+              Stateless volumes on stateful containers will be wiped on container stop.
           storage_pool:
             oneOf:
               - type: boolean
diff --git a/components/schemas/vms/config/volumes/VirtualMachineVolumeConfig.yml b/components/schemas/vms/config/volumes/VirtualMachineVolumeConfig.yml
index 4ee0eec1..77cc1489 100644
--- a/components/schemas/vms/config/volumes/VirtualMachineVolumeConfig.yml
+++ b/components/schemas/vms/config/volumes/VirtualMachineVolumeConfig.yml
@@ -21,6 +21,15 @@ properties:
               - type: boolean
               - type: "null"
             description: Indicates if the volume is part of a storage pool.
+          stateless:
+            type: 
+              - boolean
+              - "null"
+            default: false
+            description: > 
+              If set to true, this volume will be treated as ephemeral. Stateless volumes will **NOT** be migrated.
+
+              Base volumes cannot be stateless.
       - type: "null"
     description: Configuration details for a local volume.
   external: