---
title: "Delete Tenant"
method: DELETE
path: "/v1/tenant/{tenant_id}/"
---

# Delete Tenant

`DELETE /v1/tenant/{tenant_id}/`

Delete a tenant by passing it's ID. Deletion does not affect in-flight notifications, which complete with the settings that were in effect at trigger time. When the tenant has sub-tenants, use `children_action` in the request body to control what happens to them.

## Path parameters

- `tenant_id` string, required

## Request body

- object
  - `children_action` 'orphan' | 'reassign' | 'delete' — Only applies when the tenant has [sub-tenants](/docs/sub-tenants). `orphan` (default) promotes sub-tenants to root tenants. `reassign` moves sub-tenants under `reassign_to` tenant. `delete` deletes every sub-tenant in the subtree. Ignored for tenants with no sub-tenants.
  - `reassign_to` string — Target parent when `children_action = reassign`. Required in that case; must reference an existing tenant. See [sub-tenants](/docs/sub-tenants).

## Response `204`

204 - No Content

## Other responses

- `400` — 400 - Bad Request. Returned when `reassign_to` is missing on a reassign, sent on a delete, references a non-existent tenant, or when the resulting move would exceed the 5-level limit.
- `404` — 404 - Not Found

## Changes

- **2026-08-30** `ea7b2f7c41a9` — 2 info
  - added optional request body
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/suprsend/apis/suprsend-api/changes/v1/tenant/:tenant_id/delete.md)

---

[API](https://skmtc.dev/suprsend/apis/suprsend-api.md) · [All operations](https://skmtc.dev/suprsend/apis/suprsend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/suprsend/suprsend-api/revisions/ea7b2f7c41a9/schema)