---
title: "Remove a recipient from a schedule."
method: DELETE
path: "/v1/dashboards/{id}/export-schedules/{sid}/recipients/{rid}"
tags: ["exports"]
---

# Remove a recipient from a schedule.

`DELETE /v1/dashboards/{id}/export-schedules/{sid}/recipients/{rid}`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/dashboards/{id}/export-schedules/{sid}/recipients/{rid}`
- Auth: one of:
  - API key in cookie `dvt_session`
  - HTTP bearer

Removes a recipient, regardless of their current approval status. Requires
`dashboard:write`. Idempotent from the caller's perspective — 404 is returned
if the recipient does not exist in this schedule.

## Response `204`

Removed.

## 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)