v4

latestOpenAPI 3.1.02026-08-08221179273.1 KB
scheduled-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"}