---
title: "POST /api/v1/tenants/bulk-delete"
method: POST
path: "/api/v1/tenants/bulk-delete"
tags: ["Tenants"]
---

# POST /api/v1/tenants/bulk-delete

`POST /api/v1/tenants/bulk-delete`

## Request

- Base URL: `https://api.immy.bot` (the document declares no server; this is the origin it was published from)
- URL: `https://api.immy.bot/api/v1/tenants/bulk-delete`
- Auth: none declared

## Request body

- BulkDeleteRequest
  - `ids` integer[], nullable
  - `permanent` boolean
  - `deleteOwnedEntities` boolean
  - `newOwnerTenantId` integer, nullable

## Response `200`

OK

- DeleteTenantsCmdResponse
  - `success` boolean
  - `tenantResults` DeleteTenantResult[], nullable
    - `tenantId` integer
    - `success` boolean
    - `failedReason` string, nullable
  - `message` string, nullable

---

[API](https://skmtc.dev/immy/apis/immy-bot-api.md) · [All operations](https://skmtc.dev/immy/apis/immy-bot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immy/apis/immy-bot-api/revisions/559d0e4b39d3?raw)