From 7dcd52ac6293abf3a32ed8f7b1c90ef59a5081c9 Mon Sep 17 00:00:00 2001
From: James Sandford <james.sandford@bbc.co.uk>
Date: Mon, 15 Jun 2026 16:53:52 +0100
Subject: [PATCH] Add missing return codes to webhooks

---
 api/TimeAddressableMediaStore.yaml | 24 ++++++++++++++++++++++++
 api/schemas/webhook-get.json       |  2 +-
 2 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/api/TimeAddressableMediaStore.yaml b/api/TimeAddressableMediaStore.yaml
index 3b4400e1..02638ebd 100644
--- a/api/TimeAddressableMediaStore.yaml
+++ b/api/TimeAddressableMediaStore.yaml
@@ -2534,6 +2534,9 @@ webhooks:
                   properties:
                     flow:
                       $ref: "schemas/flow.json"
+      responses:
+        "200":
+          description: Webhook received successfully
   flows/updated:
     post:
       security:
@@ -2563,6 +2566,9 @@ webhooks:
                   properties:
                     flow:
                       $ref: "schemas/flow.json"
+      responses:
+        "200":
+          description: Webhook received successfully
   flows/deleted:
     post:
       security:
@@ -2592,6 +2598,9 @@ webhooks:
                   properties:
                     flow_id:
                       $ref: "schemas/uuid.json"
+      responses:
+        "200":
+          description: Webhook received successfully
   flows/segments_added:
     post:
       security:
@@ -2627,6 +2636,9 @@ webhooks:
                       type: array
                       items:
                         $ref: 'schemas/flow-segment.json'
+      responses:
+        "200":
+          description: Webhook received successfully
   flows/segments_deleted:
     post:
       security:
@@ -2661,6 +2673,9 @@ webhooks:
                     timerange:
                       description: The timerange of Segments that have been deleted. The timerange MUST intersect with a Segment which has been deleted at both start and end (e.g. it cannot start or end in empty space).
                       $ref: 'schemas/timerange.json'
+      responses:
+        "200":
+          description: Webhook received successfully
   sources/created:
     post:
       security:
@@ -2690,6 +2705,9 @@ webhooks:
                   properties:
                     source:
                       $ref: "schemas/source.json"
+      responses:
+        "200":
+          description: Webhook received successfully
   sources/updated:
     post:
       security:
@@ -2719,6 +2737,9 @@ webhooks:
                   properties:
                     source:
                       $ref: "schemas/source.json"
+      responses:
+        "200":
+          description: Webhook received successfully
   sources/deleted:
     post:
       security:
@@ -2748,6 +2769,9 @@ webhooks:
                   properties:
                     source_id:
                       $ref: "schemas/uuid.json"
+      responses:
+        "200":
+          description: Webhook received successfully
 components:
   responses:
     trait_resource_listing_head_200:
diff --git a/api/schemas/webhook-get.json b/api/schemas/webhook-get.json
index cbb6f145..6da35aa0 100644
--- a/api/schemas/webhook-get.json
+++ b/api/schemas/webhook-get.json
@@ -13,7 +13,7 @@
             ],
             "properties": {
                 "error": {
-                    "description": "Provides more information for the error status, as described by the [Error](#/schemas/error) type",
+                    "description": "Provides more information for the error status, as described by the [Error](#/schemas/error) type. Amongst other conditions, implementations MAY use this field to indicate failure to deliver webhooks resulting in return codes other than the 200 Success described in the the webhook event schemas.",
                     "$ref": "error.json"
                 },
                 "status": {