This install's shared dispatcher — observed heartbeat, declared role, and the admin setup SQL (DVT-4797).
INSTALL-LEVEL, not per-schedule: there is exactly one shared dispatcher task per account (DVT_SCHEDULES.PUBLIC.DVT_REPORT_DISPATCHER), so its observed state and declared role are an org-wide fact. Returns the identical adminSetupSql text GET .../email-schedules/{sid}/setup returns per schedule, plus when the dispatcher last called in, as which role, and whether that role matches what an admin declared with PUT /v1/email-dispatcher.
Requires dashboard:write, checked at the ORG level (there is no single dashboard to resource-scope this read against) — the weakest capability an editor who can open any dashboard's Schedule tab already holds. Same 404-feature-disabled gate as the rest of the email-schedule group, and the same snowflake-mode requirement.
Request
- Base URL: http://localhost:8080
- URL: http://localhost:8080/v1/email-dispatcher
- Auth: one of:
- API key in cookie dvt_session
- HTTP bearer
Query parameters
A Snowflake warehouse this install already uses, if the caller knows one — rendering adminSetupSql with that warehouse instead of the <your_warehouse> placeholder. Absent renders the placeholder, as always. A value containing two consecutive $ characters is refused (422, see InvalidWarehouse) even though the pattern above admits a lone $.
Response
The dispatcher's observed state and the admin setup statements.
Changes
No recorded changes to this operation across all 1 revision of this API.