From 995362a81e08060eda9d49950ba09e1cb0c11e72 Mon Sep 17 00:00:00 2001
From: Dan Johns <60505442+danjhd@users.noreply.github.com>
Date: Tue, 25 Aug 2026 20:02:47 +0100
Subject: [PATCH 1/2] Add Flow status endpoints to TimeAddressableMediaStore

---
 api/TimeAddressableMediaStore.yaml | 72 ++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)

diff --git a/api/TimeAddressableMediaStore.yaml b/api/TimeAddressableMediaStore.yaml
index 735a8468..8ee095ae 100644
--- a/api/TimeAddressableMediaStore.yaml
+++ b/api/TimeAddressableMediaStore.yaml
@@ -2237,6 +2237,78 @@ paths:
           description: Forbidden. You do not have permission to modify this Flow. It may be marked read-only.
         "404":
           description: The requested Flow ID in the path is invalid.
+  /flows/{flowId}/status:
+    parameters:
+      - name: flowId
+        in: path
+        required: true
+        schema:
+          $ref: 'schemas/uuid.json'
+        description: The Flow identifier.
+    head:
+      summary: Flow Status
+      description: Return Flow status path headers
+      operationId: HEAD_flows-flowId-status
+      tags:
+        - Flows
+      responses:
+        "200":
+          $ref: '#/components/responses/trait_resource_info_head_200'
+        "404":
+          description: The requested Flow does not exist.
+    get:
+      summary: Flow Status
+      description: Returns the Flow status property.
+      operationId: GET_flows-flowId-status
+      tags:
+        - Flows
+      responses:
+        "200":
+          description: ""
+          content:
+            application/json:
+              example: |
+                "closed_complete"
+              schema:
+                $ref: schemas/flow-status.json
+        "404":
+          description: The requested Flow does not exist.
+    put:
+      summary: Create or Update Flow Status
+      description: Create or update the status property.
+      operationId: PUT_flows-flowId-status
+      tags:
+        - Flows
+      requestBody:
+        content:
+          application/json:
+            example: |
+              "closed_complete"
+            schema:
+              $ref: schemas/flow-status.json
+        required: true
+      responses:
+        "204":
+          description: No content. The status has been created or updated.
+        "400":
+          description: Bad request. Invalid Flow status.
+        "403":
+          description: Forbidden. You do not have permission to modify this Flow. It may be marked read-only.
+        "404":
+          description: The requested Flow does not exist.
+    delete:
+      summary: Delete Flow Status
+      description: Delete the status property.
+      operationId: DELETE_flows-flowId-status
+      tags:
+        - Flows
+      responses:
+        "204":
+          description: No content. The Flow status property has been deleted.
+        "403":
+          description: Forbidden. You do not have permission to modify this Flow. It may be marked read-only.
+        "404":
+          description: The requested Flow ID in the path is invalid.  
   /flows/{flowId}/segments:
     parameters:
       - name: flowId

From 12e6e3c211810c823e92a4d172210db38a5abfcc Mon Sep 17 00:00:00 2001
From: Dan Johns <danjhd@amazon.com>
Date: Tue, 25 Aug 2026 20:24:30 +0100
Subject: [PATCH 2/2] lint error fix

---
 api/TimeAddressableMediaStore.yaml | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/api/TimeAddressableMediaStore.yaml b/api/TimeAddressableMediaStore.yaml
index 8ee095ae..29c38b8d 100644
--- a/api/TimeAddressableMediaStore.yaml
+++ b/api/TimeAddressableMediaStore.yaml
@@ -2267,8 +2267,7 @@ paths:
           description: ""
           content:
             application/json:
-              example: |
-                "closed_complete"
+              example: "closed_complete"
               schema:
                 $ref: schemas/flow-status.json
         "404":
@@ -2282,8 +2281,7 @@ paths:
       requestBody:
         content:
           application/json:
-            example: |
-              "closed_complete"
+            example: "closed_complete"
             schema:
               $ref: schemas/flow-status.json
         required: true