> ## Documentation Index
> Fetch the complete documentation index at: https://docs.urban-things.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Tenant

## Overview

Delete a tenant (organization). This uses soft deletes, so the tenant can be recovered if needed.

## Authorization

* User must be authenticated with a valid Bearer token
* User must have ADMIN role in the tenant

## Soft Deletes

Tenants are soft-deleted, meaning:

* The tenant is marked as deleted but not removed from the database
* Associated data is preserved
* The tenant can be restored if needed
* Deleted tenants don't appear in normal queries

## Important Considerations

Before deleting a tenant:

* Ensure all team members are notified
* Export any important data
* Consider archiving instead of deleting
* Review associated products, orders, and customers

## Example Usage

```bash theme={null}
curl -X DELETE \
  https://faisalshop.mvp-apps.ae/api/v2/admin/tenants/123 \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

```javascript theme={null}
await axios.delete(
  `/api/v2/admin/tenants/${tenantId}`,
  {
    headers: {
      Authorization: `Bearer ${token}`
    }
  }
);
```


## OpenAPI

````yaml DELETE /api/v2/admin/tenants/{id}
openapi: 3.1.0
info:
  title: Urban Things API
  description: Multi-tenant e-commerce platform API
  version: 2.0.0
  contact:
    email: info@faisalkc.com
servers:
  - url: https://faisalshop.mvp-apps.ae
    description: Production server
  - url: http://localhost:3000
    description: Development server
security:
  - bearerAuth: []
paths:
  /api/v2/admin/tenants/{id}:
    delete:
      tags:
        - Tenants
      summary: Delete tenant
      parameters:
        - $ref: '#/components/parameters/TenantIdPath'
      responses:
        '200':
          description: Tenant deleted
components:
  parameters:
    TenantIdPath:
      name: tenantId
      in: path
      required: true
      schema:
        type: integer
      description: Tenant ID
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````