dashboards

Share a dashboard to a Snowflake role.

Snowflake-mode only (DVT-1670/DVT-1723): shares the dashboard to a Snowflake role — any caller who lives-holds that role gains read access. Requires share:manage on the dashboard (owner or a live dvt_admin; an owner whose LIVE tier is viewer is refused with 403 — DVT-4721, the owner needs dvt_editor or dvt_admin). Idempotent: sharing an already-shared role is a no-op. PUBLIC (and any other broadly-held pseudo-role) is rejected with 400 — sharing to PUBLIC would grant account-wide read, bypassing visibility: public. Outside snowflake mode this endpoint does not exist (404).

DVT-2260 (warn, don't block): the share is always created, but when the sharer's own live Snowflake role set resolves cleanly and does not contain the target role, the 201 body carries an advisory warning — the role may be misspelled or absent from the account (in which case the share grants nobody access), or simply a role the sharer does not hold, which is normal. The check is best-effort and fails open: no warning is returned when no live caller session is available or the resolve fails, so the absence of a warning is not proof the role exists.

post/v1/dashboards/{id}/role-shares

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/role-shares
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Request body

snowflakeRolestring required

The Snowflake role name to share the dashboard to.

Response

Role share created (or already existed).

Changes

No recorded changes to this operation across all 1 revision of this API.