---
title: "Delete a tenant"
method: DELETE
path: "/tenants/{id}"
tags: ["Tenants"]
---

# Delete a tenant

`DELETE /tenants/{id}`

## Request

- Base URL: `https://api.groundmail.dev`
- URL: `https://api.groundmail.dev/tenants/{id}`
- Auth: HTTP bearer

Deletes the tenant and its suppression list. Its domains go back to the account, its sent emails stay in your history, API keys limited to it are revoked, and it is removed from webhook tenant filters (an endpoint left with no tenants is disabled).

## Response `200`

Tenant deleted

- object
  - `ok` boolean, required
  - `id` string, required
  - `external_id` string, required
  - `deleted` boolean, required

## Other responses

- `401`: Missing or invalid API key
- `404`: Tenant not found

---

[API](https://skmtc.dev/groundmail/apis/groundmail-api.md) · [All operations](https://skmtc.dev/groundmail/apis/groundmail-api/llms.txt) · [OpenAPI document](https://skmtc.dev/groundmail/apis/groundmail-api/revisions/479821c9fecf?raw)