Admin Notification Dispatcher

List notification dispatch log entries

{
  "data": [
    {
      "dispatch_id": "dsp_aR2mQn",
      "org_id": "org_kNr8aQ",
      "type": "certification_reminder",
      "recipient_user_id": "usr_hA3mXp",
      "status": "delivered",
      "sent_at": "2026-03-20T08:00:00Z"
    },
    {
      "dispatch_id": "dsp_bC5tPk",
      "org_id": "org_kNr8aQ",
      "type": "certification_reminder",
      "recipient_user_id": "usr_bQ9vTk",
      "status": "failed",
      "sent_at": "2026-03-20T08:00:01Z",
      "error": "Email address not verified"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 38
  }
}

Get details of a single dispatch event

{
  "data": {
    "dispatch_id": "dsp_aR2mQn",
    "org_id": "org_kNr8aQ",
    "type": "certification_reminder",
    "recipient_user_id": "usr_hA3mXp",
    "status": "delivered",
    "subject": "Your certification expires in 30 days",
    "sent_at": "2026-03-20T08:00:00Z",
    "delivered_at": "2026-03-20T08:00:03Z"
  }
}

Send a certification reminder to a single user

{
  "user_id": "usr_hA3mXp"
}

{
  "data": {
    "dispatch_id": "dsp_xP8nKv",
    "user_id": "usr_hA3mXp",
    "type": "certification_reminder",
    "status": "queued",
    "queued_at": "2026-03-26T11:00:00Z"
  }
}

Send bulk certification reminders to all users in org whose cert expires within N days

{
  "org_id": "org_kNr8aQ",
  "days_threshold": 30,
  "include_sub_orgs": true
}

{
  "data": {
    "org_id": "org_kNr8aQ",
    "days_threshold": 30,
    "total_eligible": 12,
    "dispatched": 12,
    "failed": 0,
    "dispatch_ids": [
      "dsp_xP8nKv",
      "dsp_yQ9oLw"
    ],
    "dispatched_at": "2026-03-26T11:00:05Z"
  }
}

Retry or update a failed dispatch event

{
  "action": "retry"
}

{
  "data": {
    "dispatch_id": "dsp_bC5tPk",
    "status": "queued",
    "retried_at": "2026-03-26T11:05:00Z"
  }
}

Cancel a queued notification dispatch

{
  "data": {
    "dispatch_id": "dsp_xP8nKv",
    "status": "cancelled",
    "cancelled_at": "2026-03-26T11:01:00Z"
  }
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}