Delete a tenant.

DELETE

/api/admin/tenants/{id}

Code sample: Shell / cURL

curl --request DELETE \
  --url https://auth.example.com/api/admin/tenants/example \
  --header 'Authorization: Bearer <token>'

Queue asynchronous tenant deletion. The tenant is moved out of the active lifecycle immediately and the background deletion job removes tenant data later.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Responses

202

Tenant deletion job accepted.

Media type application/json

object

job_id

required

string

status

required

string

Allowed values: pending

estimated_completion

required

Unix timestamp in seconds.

integer format: int64

key

additional properties

Example

{
  "job_id": "018f3f7c-85b0-7c5d-a6b6-1c3a6e6b9e01",
  "status": "pending",
  "estimated_completion": 1770007200
}