From e7959dc7b8160d909b24de6cb3b6a22bad6f70db Mon Sep 17 00:00:00 2001
From: Bryce <blewis@cycle.io>
Date: Wed, 21 Jan 2026 07:31:48 -0800
Subject: [PATCH 1/3] add service versions to environment meta

---
 components/schemas/environments/EnvironmentMeta.yml | 10 ++++++++++
 platform/paths/environments/environment.yml         |  1 +
 platform/paths/environments/environments.yml        |  1 +
 3 files changed, 12 insertions(+)

diff --git a/components/schemas/environments/EnvironmentMeta.yml b/components/schemas/environments/EnvironmentMeta.yml
index b7d1beeb..f9c3e491 100644
--- a/components/schemas/environments/EnvironmentMeta.yml
+++ b/components/schemas/environments/EnvironmentMeta.yml
@@ -28,3 +28,13 @@ properties:
           $ref: "../containers/summaries/ContainerImageSummary.yml"
         environment:
           $ref: "../containers/summaries/ContainerEnvironmentSummary.yml"
+  service_versions:
+    type: object
+    additionalProperties:
+      type: object
+      required: [version, last_updated]
+      properties:
+        version:
+          type: string
+        last_updated:
+          $ref: ../DateTime.yml
diff --git a/platform/paths/environments/environment.yml b/platform/paths/environments/environment.yml
index a6cbaaee..3410f587 100644
--- a/platform/paths/environments/environment.yml
+++ b/platform/paths/environments/environment.yml
@@ -29,6 +29,7 @@ get:
             - containers
             - containers_count
             - instances_count
+            - service_versions
     - name: include
       in: query
       required: false
diff --git a/platform/paths/environments/environments.yml b/platform/paths/environments/environments.yml
index f23725e6..9ab717c9 100644
--- a/platform/paths/environments/environments.yml
+++ b/platform/paths/environments/environments.yml
@@ -22,6 +22,7 @@ get:
             - containers
             - containers_count
             - instances_count
+            - service_versions
     - name: include
       in: query
       required: false

From e49b1b75ffbdcabae9d392d915a8f7671bbeeed9 Mon Sep 17 00:00:00 2001
From: Bryce <blewis@cycle.io>
Date: Wed, 21 Jan 2026 07:54:54 -0800
Subject: [PATCH 2/3] add description

---
 components/schemas/environments/EnvironmentMeta.yml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/components/schemas/environments/EnvironmentMeta.yml b/components/schemas/environments/EnvironmentMeta.yml
index f9c3e491..b21db2a1 100644
--- a/components/schemas/environments/EnvironmentMeta.yml
+++ b/components/schemas/environments/EnvironmentMeta.yml
@@ -35,6 +35,9 @@ properties:
       required: [version, last_updated]
       properties:
         version:
+          description: A string depicting the service version.
+          example: v2025.01.01.01
           type: string
         last_updated:
+          description: The time the version was last updated.
           $ref: ../DateTime.yml

From 742f6d4bdb9d22271bb9a405ddeee2d73ae1bd74 Mon Sep 17 00:00:00 2001
From: Bryce <blewis@cycle.io>
Date: Wed, 21 Jan 2026 08:09:39 -0800
Subject: [PATCH 3/3] save

---
 components/schemas/environments/EnvironmentMeta.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/components/schemas/environments/EnvironmentMeta.yml b/components/schemas/environments/EnvironmentMeta.yml
index b21db2a1..3b08fdb1 100644
--- a/components/schemas/environments/EnvironmentMeta.yml
+++ b/components/schemas/environments/EnvironmentMeta.yml
@@ -29,10 +29,13 @@ properties:
         environment:
           $ref: "../containers/summaries/ContainerEnvironmentSummary.yml"
   service_versions:
+    description: A map where the key is the service and the value describes the version and date of last update.
     type: object
     additionalProperties:
       type: object
-      required: [version, last_updated]
+      required:
+        - version
+        - last_updated
       properties:
         version:
           description: A string depicting the service version.