/api/admin/send-daily-reportAuthenticatedSend the daily admin report (scheduled job)
Builds the last 24 hours' activity report (new users, organizations, organization MFA enforcement, captured server errors, summary statistics of the client error reports received, most active users, most popular apps and APIs, with links into the admin console) and e-mails it to the administrator mailing list. This is the scheduled job's entry point (a daily Vercel cron, or a host crontab entry for the deploy/ stack): it only accepts the deployment's cron secret, never a session. Administrators run it by hand with POST.
get_api_admin_send_daily_reportAdministrationAuthentication & permissionsAuthenticated
Any authenticated user
- Accepted credentials
- Cron secret (Bearer)
Authorization: Bearer <token>
- Cron secret (Bearer)
- Who may call
- Any authenticated user
- Notes
- Only the deployment's cron secret (
Authorization: Bearer <CRON_SECRET>) is accepted; administrator sessions and access tokens are refused (use POST). Always refused whileCRON_SECRETis unset.
Responses
| Property | Type | Description |
|---|---|---|
| ok* | true | |
| users_count* | integer | |
| organizations_count* | integer | |
| errors_count* | integer | |
| active_users_count* | integer | Users with any activity (a sign-in or an issued token) during the window |
| top_most_active_users_count* | integer | Most active users the report lists (at most 10 of |
| active_apps_count* | integer | Applications that issued a token (access or refresh) during the window |
| top_most_popular_apps_count* | integer | Most popular applications the report lists (at most 10 of |
| active_apis_count* | integer | API servers (token audiences) that received a token during the window |
| top_most_popular_apis_count* | integer | Most popular APIs the report lists (at most 10 of |
| client_errors_count* | integer | Client error reports received during the window |
| client_error_groups_count* | integer | Distinct client error groups (fingerprints) among those reports |
| organization_mfa_removals_count* | integer | Members the organization MFA enforcement removed from organizations during the window |
| window_start* | string (date-time) | Start of the 24h reporting window |
| window_end* | string (date-time) | End of the 24h reporting window (now) |
Example request
curl -X GET 'https://auth.schemavaults.com/api/admin/send-daily-report' \
-H 'Authorization: Bearer <access_token>'