---
title: "Revoke a dashboard's Snowflake role share."
method: DELETE
path: "/v1/dashboards/{id}/role-shares/{role}"
tags: ["dashboards"]
---

# Revoke a dashboard's Snowflake role share.

`DELETE /v1/dashboards/{id}/role-shares/{role}`

## Request

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

Snowflake-mode only (DVT-1670/DVT-1723): removes the dashboard's share to
the given Snowflake role. 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: revoking a role that was never (or no
longer) shared still returns 204. Outside snowflake mode this endpoint
does not exist (404).

## Response `204`

Role share revoked (or was already absent).

## Other responses

- `401`: Missing, invalid, or expired session.
- `403`: The caller's role does not permit this action.
- `404`: Resource does not exist.

---

[API](https://skmtc.dev/dvt/apis/dvt-rest-api.md) · [All operations](https://skmtc.dev/dvt/apis/dvt-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dvt/apis/dvt-rest-api/revisions/00016f504165?raw)