---
title: "Archive Tenant"
method: POST
path: "/v1/auth/tenants/{tenant_id}/archive"
tags: ["auth", "auth"]
---

# Archive Tenant

`POST /v1/auth/tenants/{tenant_id}/archive`

## Request

- Base URL: `https://api.elaan.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elaan.io/v1/auth/tenants/{tenant_id}/archive`
- Auth: none declared

Archive (deactivate) a tenant the signed-in user owns: it's hidden from
the switcher and can no longer send (the trigger refuses, fan-out skips).
Reversible via unarchive; data is retained.

## Path parameters

- `tenant_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- TenantResponse: One account the signed-in user belongs to (UI: 'account'; code: tenant).
  - `tenant_id` string, required
  - `name` string, required
  - `role` string, required
  - `is_default` boolean, required
  - `status` string: "active" or "archived". An archived account is hidden from the switcher and can no longer send — the trigger refuses it and fan-out skips it. Reversible via unarchive; data is retained.

## Other responses

- `403`: Not a member, or not the owner, of that tenant
- `404`: No such tenant
- `422`: Validation Error

---

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