Notification Service API Reference
Complete endpoint reference for the Notification Service (port 8085).
Notifications (/api/v1/notifications)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/notifications | Send a notification |
GET | /api/v1/notifications/{id} | Get notification by ID |
GET | /api/v1/notifications/tenant/{tenantId} | List tenant notifications |
GET | /api/v1/notifications/tenant/{tenantId}/user/{userId} | List user notifications |
POST | /api/v1/notifications/{id}/retry | Retry failed notification |
POST | /api/v1/notifications/{id}/cancel | Cancel pending notification |
Templates (/api/v1/templates)
| Method | Path | Description |
|---|---|---|
POST | /api/v1/templates | Create template |
GET | /api/v1/templates/{id} | Get template by ID |
GET | /api/v1/templates/tenant/{tenantId}/key/{templateKey} | Get by key |
GET | /api/v1/templates/tenant/{tenantId} | List templates |
GET | /api/v1/templates/tenant/{tenantId}/channel/{channel} | By channel |
PUT | /api/v1/templates/{id} | Update template |
DELETE | /api/v1/templates/{id} | Delete template |
POST | /api/v1/templates/tenant/{tenantId}/key/{templateKey}/preview | Preview |
Preferences (/api/v1/preferences)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/preferences/tenant/{tenantId}/user/{userId} | Get preferences |
PUT | /api/v1/preferences/tenant/{tenantId}/user/{userId} | Update preferences |
DELETE | /api/v1/preferences/tenant/{tenantId}/user/{userId} | Reset to defaults |
Tracking (/api/v1/notifications/track)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/notifications/track/open/{trackingId} | Track email open |
GET | /api/v1/notifications/track/click/{trackingId} | Track link click |
GET | /api/v1/notifications/track/analytics/{tenantId} | Analytics summary |
GET | /api/v1/notifications/track/stats/{notificationId} | Notification stats |
GET | /api/v1/notifications/track/timeline/{tenantId} | Engagement timeline |
Unsubscribe (/api/v1/notifications/unsubscribe)
| Method | Path | Description |
|---|---|---|
GET | /api/v1/notifications/unsubscribe | Unsubscribe via link |
POST | /api/v1/notifications/unsubscribe/one-click | One-click (RFC 8058) |
POST | /api/v1/notifications/unsubscribe | Unsubscribe via API |
GET | /api/v1/notifications/unsubscribe/status | Subscription status |
PUT | /api/v1/notifications/unsubscribe/preferences | Update preferences |
POST | /api/v1/notifications/unsubscribe/resubscribe | Resubscribe |
GET | /api/v1/notifications/unsubscribe/stats/{tenantId} | Unsubscribe stats |
GET | /api/v1/notifications/unsubscribe/history/{tenantId} | History |
GET | /api/v1/notifications/unsubscribe/categories | Categories |