{"openapi":"3.0.3","info":{"title":"notifications API","version":"1.0.0"},"components":{"schemas":{}},"paths":{"/api/notifications/livez":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/notifications/readyz":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/notifications/health":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/api/notifications/device-token":{"post":{"summary":"Register a device token","tags":["Notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1},"platform":{"type":"string","enum":["ios","android","web"]}},"required":["token","platform"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string","format":"uuid"},"token":{"type":"string"},"platform":{"type":"string"},"active":{"type":"boolean"}},"required":["id","userId","token","platform","active"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}},"delete":{"summary":"Remove a device token","tags":["Notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1}},"required":["token"],"additionalProperties":false}}}},"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"],"nullable":true}}}}}}},"/api/notifications/preferences":{"get":{"summary":"Get notification preferences","tags":["Notifications"],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string","format":"uuid"},"dailyJournalReminder":{"type":"boolean"},"dailyReminderTime":{"type":"string"},"weeklySummaryReady":{"type":"boolean"},"newInsightAvailable":{"type":"boolean"},"marketingEmails":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","userId","dailyJournalReminder","dailyReminderTime","weeklySummaryReady","newInsightAvailable","marketingEmails","createdAt","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}},"patch":{"summary":"Update notification preferences","tags":["Notifications"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dailyJournalReminder":{"type":"boolean"},"dailyReminderTime":{"type":"string","pattern":"^\\d{2}:\\d{2}$"},"weeklySummaryReady":{"type":"boolean"},"newInsightAvailable":{"type":"boolean"},"marketingEmails":{"type":"boolean"}},"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"userId":{"type":"string","format":"uuid"},"dailyJournalReminder":{"type":"boolean"},"dailyReminderTime":{"type":"string"},"weeklySummaryReady":{"type":"boolean"},"newInsightAvailable":{"type":"boolean"},"marketingEmails":{"type":"boolean"},"createdAt":{"type":"string"},"updatedAt":{"type":"string"}},"required":["id","userId","dailyJournalReminder","dailyReminderTime","weeklySummaryReady","newInsightAvailable","marketingEmails","createdAt","updatedAt"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/api/notifications/send/":{"post":{"summary":"Send a push notification to a user (internal)","tags":["Send"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"title":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"data":{"type":"object","additionalProperties":{"type":"string"}}},"required":["userId","title","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"sent":{"type":"boolean"},"tokenCount":{"type":"number"}},"required":["sent","tokenCount"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/api/notifications/send/email":{"post":{"summary":"Send email via SendGrid","tags":["Send"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"anyOf":[{"type":"string","format":"email"},{"type":"array","items":{"type":"string","format":"email"}}]},"subject":{"type":"string","minLength":1},"html":{"type":"string","minLength":1},"text":{"type":"string"}},"required":["to","subject","html"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"messageId":{"type":"string"},"status":{"type":"string"}},"required":["messageId","status"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/api/notifications/send/sms":{"post":{"summary":"Send SMS via Twilio","tags":["Send"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"to":{"type":"string","minLength":1},"body":{"type":"string","minLength":1}},"required":["to","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"messageId":{"type":"string"},"status":{"type":"string"}},"required":["messageId","status"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}},"/api/notifications/send/push":{"post":{"summary":"Send push notification via OneSignal","tags":["Send"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userId":{"type":"string","format":"uuid"},"userIds":{"type":"array","items":{"type":"string","format":"uuid"}},"title":{"type":"string","minLength":1},"body":{"type":"string","minLength":1},"data":{"type":"object","additionalProperties":{"type":"string"}}},"required":["title","body"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"notificationId":{"type":"string"},"recipients":{"type":"number"}},"required":["notificationId","recipients"],"additionalProperties":false}},"required":["data"],"additionalProperties":false}}}}}}}}}