---
title: "Unsubscribe"
method: DELETE
path: "/api/v1/notifications/subscriptions/{entity_id}"
tags: ["notifications"]
---

# Unsubscribe

`DELETE /api/v1/notifications/subscriptions/{entity_id}`

Switch email off for an entity, company-wide. Idempotent, owner/admin only.

Gated exactly like subscribe. It was ungated under the per-user model, where
the row was the caller's own preference; the row is the company's now, and
an ungated DELETE would let any member mute an entity for every colleague.

## Path parameters

- `entity_id` string, uuid, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

## Changes

> 35 revisions in range; 1 not diffed.

- **2026-09-09** `b581494ebe52` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/notifications/subscriptions/:entity_id/delete.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) · [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/77d4fd215b57?raw)
