---
title: "Tenant Delete"
method: DELETE
path: "/1/tenants/{tenantId}"
tags: ["Tenant"]
---

# Tenant Delete

`DELETE /1/tenants/{tenantId}`

## Request

- Base URL: `http://localhost:3000/api`
- URL: `http://localhost:3000/api/1/tenants/{tenantId}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/docs/1/tenants/:tenantId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete a tenant. This will sever the connection between the vendor and tenant organizations. 
If you wish to re-invite the tenant, simply send a new invite and have the tenant admin choose to Link Organizations to reestablish the connection.

## Headers

- `icl-requestor-id` string, required

## Response `200`

Result of deleting a tenant

- object
  - `id` string, required: Tenant ID

## Other responses

- `401`: Unauthorized
- `422`: Unprocessable Entity Possible causes: \- Invalid tenant ID provided \- Tenant has taken control of their account (must archive tenant instead) \- Tenant has KMS configurations. Note that you must wait 36 hours after deleting all KMS configurations before deleting a tenant.

---

[API](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge.md) - [All operations](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcorelabs/apis/vendor-api-bridge/revisions/5c0e553ffa21?raw)