v4
latestOpenAPI 3.1.02026-08-08221179273.1 KBscheduled-notifications
Schedule Daily Notifications
Daily cron job endpoint to schedule notifications for all users. This should be called once per day (e.g., at midnight UTC).
For each user with push tokens:
- Randomly selects a time slot (morning/noon/night)
- Schedules a notification with content appropriate for that time
- Respects user's timezone for scheduling
Tasks are queued in Redis and processed by Celery workers. Use days_ahead to override the default 2-day lead time.
Requires x-api-key header for authentication.
post/api/scheduled-notifications/admin/schedule-daily
Query parameters
days_aheadinteger nullable
Days ahead to schedule for (default: 2)
Days ahead to schedule for (default: 2)
Headers
x-api-keystring required
Response
Successful Response
{"stackTrail":"paths:/api/scheduled-notifications/admin/schedule-daily:post:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}