Delete a tenant
Delete a tenant you own.
DELETE /tenants/{id}
Deletes a tenant. It disappears from every list. An org always keeps at least one tenant, so its last one cannot be deleted.
Authorization
Authorization: Bearer <access token>: a user token minted by the org whose
host you call. A client_credentials token is refused with 401. The caller must be an owner of the tenant.
Path parameters
| Name | Type | Description |
|---|---|---|
id | string | The tenant, tnt_…. |
Response
204 with no body.
Errors
| Status | error | When |
|---|---|---|
401 | unauthorized | No token, or an invalid, expired or ended one. See Authentication. |
403 | forbidden | You are a member of the tenant but not an owner. |
404 | not_found | No such tenant, one already deleted, a tenant you are not a member of, or an id that is not tnt_…. |
409 | conflict | It is the org’s last tenant. |
Example
curl -X DELETE https://acme.loginwith.dev/tenants/tnt_… \
-H "Authorization: Bearer eyJ…"