From 770ee003e71b0b7e13d04d0296c61783822b80cb Mon Sep 17 00:00:00 2001
From: Fred Boniface <fjla@fredboniface.co.uk>
Date: Wed, 14 Jan 2026 18:51:14 +0000
Subject: [PATCH] Add message-envelope type

---
 schemas/data-ingress/message-envelope.json | 32 ++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 schemas/data-ingress/message-envelope.json

diff --git a/schemas/data-ingress/message-envelope.json b/schemas/data-ingress/message-envelope.json
new file mode 100644
index 0000000..c644208
--- /dev/null
+++ b/schemas/data-ingress/message-envelope.json
@@ -0,0 +1,32 @@
+{
+    "$id": "https://schema.owlboard.info/data-ingress/message-envelope.schema.json",
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "MessageEnvelope",
+    "type": "object",
+    "properties": {
+        "service_name": {
+            "type": "string",
+            "description": "Name of the service submitting the update"
+        },
+        "service_id": {
+            "type": "string",
+            "description": "ID of the service sending the message - usually a hostname"
+        },
+        "data_type": {
+            "type": "string",
+            "enum": ["file"],
+            "description": "The type of data contained in this message object"
+        },
+        "sent_timestamp": {
+            "type": "integer",
+            "description": "Unix timestamp representing the time the message was sent"
+        },
+        "data_kind": {
+            "type": "string",
+            "enum": ["pis", "timetable", "knowledgebase"],
+            "description": "The data type contained in the message.  Currently supported PIS: PIS Data, Timetable: CIF or VSTP Data, Knowledgebase: Station Data"
+        }
+    },
+    "required": ["service_name", "service_id", "data_type", "sent_timestamp"],
+    "additionalProperties": true
+}
\ No newline at end of file