- Add MessageRequestSkipped event schema for handling bypassed message requests

- Update print TTL sequence diagram to show configurable fallback wait time
- Remove unused/obsolete event schemas and documentation files
- Update schema_data references from generic base schema to specific schemas
- Improved event descriptions with business context
- Fix schema references to use correct event and data schema URLs

Author: tdroza-nhs

README.md

@@ -105,6 +105,7 @@ _No common schemas defined yet._
 | **Digital Letters Mesh Inbox Message Downloaded Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.md) |
 | **Digital Letters Mesh Inbox Message Received Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.md) |
 | **Digital Letters Message Request Failed Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-failed-data.schema.md) |
+| **Digital Letters Message Request Skipped Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-skipped-data.schema.md) |
 | **Digital Letters Message Request Submitted Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-message-request-submitted-data.schema.md) |
 | **Digital Letters Pdm Resource Available Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-available-data.schema.md) |
 | **Digital Letters Pdm Resource Retries Exceeded Data** | [`src/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.yaml`](src/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.yaml) | [`schemas/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.json`](schemas/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/data/digital-letters-pdm-resource-retries-exceeded-data.schema.md) |
@@ -144,6 +145,7 @@ _No common schemas defined yet._
 | **Uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1.schema.md) |
 | **Uk.nhs.notify.digital.letters.mesh.report.sent.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.report.sent.v1.schema.md) |
 | **Uk.nhs.notify.digital.letters.messages.request.sent.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.sent.v1.schema.md) |
+| **Uk.nhs.notify.digital.letters.messages.request.skipped.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.skipped.v1.schema.md) |
 | **Uk.nhs.notify.digital.letters.messages.request.submitted.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.messages.request.submitted.v1.schema.md) |
 | **Uk.nhs.notify.digital.letters.pdm.resource.available.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.available.v1.schema.md) |
 | **Uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1** | [`src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.yaml`](src/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.yaml) | [`schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.json`](schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.md`](../../docs/cloudevents/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1.schema.md) |
@@ -176,6 +178,7 @@ _No common schemas defined yet._
 | **Uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.poller.timer.expired.v1-event.md) |
 | **Uk.nhs.notify.digital.letters.mesh.report.sent.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.report.sent.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.report.sent.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.report.sent.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.mesh.report.sent.v1-event.md) |
 | **Uk.nhs.notify.digital.letters.messages.request.sent.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.sent.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.sent.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.sent.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.sent.v1-event.md) |
+| **Uk.nhs.notify.digital.letters.messages.request.skipped.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.skipped.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.skipped.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.skipped.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.skipped.v1-event.md) |
 | **Uk.nhs.notify.digital.letters.messages.request.submitted.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.submitted.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.submitted.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.submitted.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.messages.request.submitted.v1-event.md) |
 | **Uk.nhs.notify.digital.letters.pdm.resource.available.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.available.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.available.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.available.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.available.v1-event.md) |
 | **Uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1** | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1-event.json`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1-event.json) | [`../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1-event.md`](../../docs/cloudevents/digital-letters/2025-10-draft/example-events/uk.nhs.notify.digital.letters.pdm.resource.retries.exceeded.v1-event.md) |

docs/collections/_diagrams/c4code-core-notifier.md

@@ -9,16 +9,20 @@ architecture-beta
     group coreNotifier(cloud)[CoreNotifier]
     service meshDownloaded(aws:res-amazon-eventbridge-event)[PDMResourceAvailable Event]
     service sqs(logos:aws-sqs)[CoreNotifier Queue] in coreNotifier
+    service clientConfig(aws:res-aws-systems-manager-parameter-store)[Client Configuration] in coreNotifier
     service coreNotified(aws:res-amazon-eventbridge-event)[MessageRequestSubmitted Event]
     service coreFailed(aws:res-amazon-eventbridge-event)[MessageRequestFailed Event]
+    service coreSkipped(aws:res-amazon-eventbridge-event)[MessageRequestSkipped Event]
     service notifier(logos:aws-lambda)[CoreNotifier] in coreNotifier
     service notify(server)[NHS Notify Core]
     junction j1
 
     meshDownloaded:R --> L:sqs
     sqs:R -->  L:notifier
+    clientConfig:B --> T:notifier
     notifier:B --> T:notify
-    notifier:R --> L:j1
-    j1:R -- L:coreNotified
+    notifier:R -- L:j1
+    j1:T --> L:coreNotified
+    j1:R -- L:coreSkipped
     j1:B --> L:coreFailed
 ```

docs/collections/_diagrams/c4code-printer-sendtoqueue.md

@@ -8,13 +8,15 @@ description: PDM Upload
     group createTtl(cloud)[QueueAdder]
 
     service db(aws:arch-amazon-dynamodb)[ItemsWithTTL] in createTtl
+    service clientConfig(aws:res-aws-systems-manager-parameter-store)[Client Configuration] in createTtl
     service createLambda(logos:aws-lambda)[CreateTTL] in createTtl
     service queue(logos:aws-sqs)[SQS] in createTtl
     service storedEvent(aws:res-amazon-eventbridge-event)[MESHInboxMessageDownloaded event]
     service scheduledEvent(aws:res-amazon-eventbridge-event) [ItemEnqueued event]
 
     storedEvent:R --> L:queue
     queue:R --> L:createLambda
+    clientConfig:B --> T:createLambda
     createLambda:R --> L:db
-    createLambda:T --> L:scheduledEvent
+    createLambda:B --> L:scheduledEvent
 ```

docs/collections/_diagrams/sequence-create-print-ttl.md

@@ -9,10 +9,13 @@ sequenceDiagram
   participant eb as Event Bridge
   participant sqs as SQS<br/>CreateTTLQueue
   participant createTTL as Lambda<br/>CreateTTL
+  participant ssm as SSM<br/>Parameter Store
   participant dynamo as DynamoDB
 
 
   eb ->> sqs: MESHInboxMessageDownloaded event
   sqs ->> createTTL:
-  createTTL ->> dynamo: Insert (24h TTL)
+  createTTL ->> ssm: Get FallbackWaitTime
+  ssm -->> createTTL:
+  createTTL ->> dynamo: Insert (FallbackWaitTime TTL)
 ```

docs/collections/_events/event-bus-timer-time-expired.md

@@ -4,7 +4,7 @@ type: uk.nhs.notify.digital.letters.mesh.inbox.message.downloaded.v1
 nice_name: MESHInboxMessageDownloaded
 service: MESH Services
 schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.inbox.message.downloaded.v1.schema.json
-schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letter-base-data.schema.json
+schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-downloaded-data.schema.json
 ---
 
 This is an event.

docs/collections/_events/fhir-attachment-extracted.md

@@ -4,7 +4,7 @@ type: uk.nhs.notify.digital.letters.mesh.inbox.message.received.v1
 nice_name: MESHInboxMessageReceived
 service: MESH Services
 schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.mesh.inbox.message.received.v1.schema.json
-schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letter-base-data.schema.json
+schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letters-mesh-inbox-message-received-data.schema.json
 ---
 
 This is an event.