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

# Delete Tenant

> Delete a tenant by ID



## OpenAPI

````yaml https://api.voxo.co/v2/docs/openapi.json delete /v2/admin/tenants/{id}
openapi: 3.1.0
info:
  title: VOXO API
  description: VOXO Communication Platform API
  version: 2.0.0
servers:
  - url: https://api.voxo.co
security:
  - bearerAuth: []
paths:
  /v2/admin/tenants/{id}:
    delete:
      tags:
        - Tenants
      summary: Delete Tenant
      description: Delete a tenant by ID
      parameters:
        - schema:
            type: string
            pattern: ^[1-9]\d*$
          in: path
          name: id
          required: true
          description: Tenant ID
      responses:
        '200':
          description: Deleted tenant
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    description: Tenant ID
                  name:
                    type: string
                    description: Tenant name
                  tenantCode:
                    type: string
                    description: Tenant code
                  externalBillingId:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: External billing ID
                  billingStartDate:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Billing start date
                  conduitPrefix:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Conduit prefix
                  brandId:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Brand ID
                  brandVertical:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Brand vertical
                  resellerType:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Reseller type (RESELLER or WHITELABEL)
                  globalQueueActions:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Global queue actions flag
                  queuePauseReasons:
                    anyOf:
                      - type: array
                        items:
                          type: string
                      - type: 'null'
                    description: Queue pause reasons
                  parkinglotTimeout:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Parking lot timeout in seconds
                  incomingRingsCount:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Incoming rings count
                  recordingStorage:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Recording storage type (DEFAULT or AWS3)
                  recordingHost:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Recording host URL
                  recordingUser:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Recording storage username
                  recordingPassword:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Recording storage password
                  recordingDir:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Recording storage directory
                  salesforceDomain:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Salesforce domain URL
                  salesforceCTITasks:
                    anyOf:
                      - type: string
                      - type: 'null'
                    description: Salesforce CTI tasks setting
                  autoPortReject:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Auto port reject flag
                  callWaiting:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Call waiting flag
                  disabled:
                    type: number
                    description: Whether tenant is disabled (1 = yes, 0 = no)
                  enableSoftphonePark:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Enable softphone park flag
                  isResidential:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Whether tenant is residential
                  mfaEnabled:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Whether MFA is enabled
                  recordUserSessions:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Whether user sessions are recorded
                  sameRing:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Same ring flag
                  forceVoicemailPin:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Force voicemail PIN flag
                  billingV2:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Whether billing V2 is enabled
                  timezone:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: number
                            description: Timezone ID
                          name:
                            type: string
                            description: Timezone name
                        required:
                          - id
                          - name
                        additionalProperties: false
                      - type: 'null'
                    description: Timezone details
                  musicOnHold:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: number
                            description: Music on hold ID
                          name:
                            type: string
                            description: Music on hold name
                        required:
                          - id
                          - name
                        additionalProperties: false
                      - type: 'null'
                    description: Music on hold details
                  routingProfile:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: number
                            description: Routing profile ID
                          name:
                            type: string
                            description: Routing profile name
                        required:
                          - id
                          - name
                        additionalProperties: false
                      - type: 'null'
                    description: Routing profile details
                  partner:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: number
                            description: Partner ID
                          name:
                            type: string
                            description: Partner name
                          tenantId:
                            type: number
                            description: Partner tenant ID
                        required:
                          - id
                          - name
                          - tenantId
                        additionalProperties: false
                      - type: 'null'
                    description: Partner details
                  branch:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: number
                            description: Default branch ID
                          name:
                            type: string
                            description: Default branch name
                        required:
                          - id
                          - name
                        additionalProperties: false
                      - type: 'null'
                    description: Default branch details
                  isResellerAccount:
                    type: number
                    description: Whether this is a reseller account (1 = yes, 0 = no)
                  parkinglotCount:
                    anyOf:
                      - type: number
                      - type: 'null'
                    description: Number of parking lot spaces
                  notes:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          description: Note ID
                        name:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Author name
                        note:
                          type: string
                          description: Note content
                        userId:
                          type: number
                          description: Author user ID
                      required:
                        - id
                        - name
                        - note
                        - userId
                      additionalProperties: false
                    description: Account notes
                  products:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          description: Product pricing ID
                        productId:
                          type: number
                          description: Product ID
                        name:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Product name
                        description:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Product description
                        price:
                          type: string
                          description: Product price
                        customQuantity:
                          type: number
                          description: Custom quantity
                        customDescription:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Custom description
                        isCustom:
                          anyOf:
                            - type: boolean
                            - type: 'null'
                          description: Whether product is custom
                        tenantId:
                          type: number
                          description: Tenant ID
                      required:
                        - id
                        - productId
                        - name
                        - description
                        - price
                        - customQuantity
                        - customDescription
                        - isCustom
                        - tenantId
                      additionalProperties: false
                    description: Product pricing entries
                  integrations:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          description: Integration ID
                        name:
                          type: string
                          description: Integration name
                        category:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Integration category
                      required:
                        - id
                        - name
                        - category
                      additionalProperties: false
                    description: Active integrations
                  billingInfo:
                    anyOf:
                      - type: object
                        properties:
                          firstName:
                            type: string
                            description: Billing contact first name
                          lastName:
                            type: string
                            description: Billing contact last name
                          email:
                            type: string
                            description: Billing contact email
                          phoneNumber:
                            type: string
                            description: Billing contact phone number
                          street:
                            type: string
                            description: Billing street address
                          city:
                            type: string
                            description: Billing city
                          state:
                            type: string
                            description: Billing state code
                          postalCode:
                            type: string
                            description: Billing postal code
                        required:
                          - firstName
                          - lastName
                          - email
                          - phoneNumber
                          - street
                          - city
                          - state
                          - postalCode
                        additionalProperties: false
                      - type: 'null'
                    description: Billing contact info mapped from QuickBooks customer
                  conduits:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                          description: Destination tenant ID
                        name:
                          type: string
                          description: Destination tenant name
                        conduitPrefix:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Conduit prefix
                      required:
                        - id
                        - name
                        - conduitPrefix
                      additionalProperties: false
                    description: Configured conduits
                required:
                  - id
                  - name
                  - tenantCode
                  - externalBillingId
                  - billingStartDate
                  - conduitPrefix
                  - brandId
                  - brandVertical
                  - resellerType
                  - globalQueueActions
                  - queuePauseReasons
                  - parkinglotTimeout
                  - incomingRingsCount
                  - recordingStorage
                  - recordingHost
                  - recordingUser
                  - recordingPassword
                  - recordingDir
                  - salesforceDomain
                  - salesforceCTITasks
                  - autoPortReject
                  - callWaiting
                  - disabled
                  - enableSoftphonePark
                  - isResidential
                  - mfaEnabled
                  - recordUserSessions
                  - sameRing
                  - forceVoicemailPin
                  - billingV2
                  - timezone
                  - musicOnHold
                  - routingProfile
                  - partner
                  - branch
                  - isResellerAccount
                  - parkinglotCount
                  - notes
                  - products
                  - integrations
                  - billingInfo
                  - conduits
                additionalProperties: false
        '400':
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  message:
                    type: string
                  code:
                    type: number
                  validationErrors:
                    type: array
                    items:
                      type: string
                required:
                  - name
                  - message
                  - code
                additionalProperties: false
        '403':
          description: Error response
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  message:
                    type: string
                  code:
                    type: number
                  validationErrors:
                    type: array
                    items:
                      type: string
                required:
                  - name
                  - message
                  - code
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````