Schedule dashboard email
fastero_schedule_dashboard_emailEmail a dashboard on a timetable to members of this organisation. Each run runs every query widget's query fresh (a widget pinned from a notebook cell shows its notebook's latest run, so schedule the notebook before the email) and emails each recipient the dashboard itself (its number cards, up to twelve charts as pictures, and each table's first ten rows) and a short summary, with a PDF of the whole dashboard attached and a button that opens the dashboard in Fastero after signing in. No public link is made; fastero_share_dashboard is the tool that publishes one. Recipients must be members of the organisation, up to 20, and an address outside it is refused: only a person can add one, in the Fastero app. Each recipient can stop this one report from a link in the email (only they can start it again); with no emails it goes to you. The cadence is at most once an hour, in the timezone given. Asking again for the same dashboard updates the timetable and recipients rather than adding a second schedule. If a run fails, only you are told. Given slackChannel, each run also posts the dashboard's name, a link to it and its charts as pictures to that channel of the organisation's Slack (no PDF), and it posts even when no recipient gets the email. Returns scheduleId, cadence, timezone, nextRunAt, recipients, slackChannel (the channel's id, when it posts to Slack) and created (false when it updated your existing schedule). fastero_set_schedule_enabled switches it off. Owners, admins and editors of the project can schedule one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | No | Up to 20 addresses, each belonging to a member of the organisation. | |
| cadence | Yes | Five-field cron (minute hour day-of-month month day-of-week), at most once an hour, read in `timezone`. '0 9 * * 1' is 09:00 every Monday; '0 8 1 * *' is 08:00 on the 1st of each month. | |
| timezone | Yes | IANA timezone the cadence is read in, e.g. 'Europe/Berlin' or 'America/New_York'. | |
| projectId | Yes | The project’s id, from fastero_list_projects. | |
| dashboardId | Yes | A dashboard’s id, from fastero_list_dashboards. | |
| slackChannel | No | A Slack channel to post the dashboard's charts as pictures to as well, by name ('#metrics') or id. Slack must be connected to the organisation and Fastero in the channel: if it is not, the call is refused and says so, and someone types /invite @Fastero in the channel. Left out, the schedule keeps the channel it has; an empty string stops posting to Slack. |