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

# Hang Up All Conferences

> Terminate all active conference rooms.

```http theme={null}
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Conference/
```

This API lets you hang up all ongoing conferences running on your account at once. All participants across all conferences will be disconnected immediately.

<Info>
  **Authentication required:**

  * `X-Auth-ID` - Your account ID (e.g., `{auth_id}`)
  * `X-Auth-Token` - Your account Auth Token
  * `Content-Type: application/json`
</Info>

<Warning>
  **Warning:** This is a destructive operation that affects ALL active conferences in your account. All participants in every conference will be disconnected immediately and cannot rejoin. This action cannot be undone.
</Warning>

<Tip>
  **Use Cases:** System maintenance, emergency shutdown, end-of-day cleanup, security incidents, platform-wide service termination, testing/development environment resets.
</Tip>

## Path parameters

| Field     | Type   | Required | Description                               |
| --------- | ------ | -------- | ----------------------------------------- |
| `auth_id` | string | Yes      | Your Vobiz account ID (e.g., `{auth_id}`) |

<Tip>
  **No request body needed.** Simply use the DELETE method on the base conference endpoint to terminate all conferences.
</Tip>

## Request Body

```json JSON theme={null}
{}
```

No request body parameters required. Send an empty JSON object.

## Response

Returns a success status code indicating all conferences have been terminated.

```text Response - 204 No Content theme={null}
HTTP Status Code: 204
```

<Tip>
  **What Happens:**

  1. All active conferences across your account are terminated simultaneously
  2. Every participant in every conference is immediately disconnected
  3. All conference rooms are closed and cannot be rejoined
  4. Any ongoing recordings across all conferences are stopped and finalized
  5. The conferences list becomes empty
</Tip>

<Info>
  **Success:** A 204 status code indicates all conferences were successfully terminated. If there were no active conferences, this still returns 204.
</Info>

## Example Request

### Hang Up All Conferences

```bash cURL Request theme={null}
curl -X DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Conference/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN"
```

<Warning>
  **Common Use Cases:**

  * **System maintenance:** Clear all conferences before scheduled maintenance window
  * **Emergency shutdown:** Immediately terminate all services during critical incidents
  * **End of day cleanup:** Automatically close all conferences at business closing time
  * **Testing environment:** Reset test environment by clearing all active conferences
  * **Security response:** Terminate all conferences during security breach response
  * **Resource management:** Force-close abandoned conferences consuming resources
</Warning>

<Warning>
  **Important Warnings:**

  * **No undo:** This operation cannot be reversed - terminated conferences cannot be restored
  * **No selective termination:** ALL conferences are affected, not just specific ones
  * **Immediate effect:** Disconnection happens instantly without warning to participants
  * **Production caution:** Use extreme caution in production environments
  * **No participant notification:** Participants receive no advance notice
</Warning>

<Tip>
  **Best Practices:**

  * **List first:** Call List All Conferences before terminating to know what will be affected
  * **Notify participants:** Send announcements to conferences before terminating (if time allows)
  * **Implement confirmation:** Require double-confirmation in UI before executing
  * **Log operations:** Always log when this endpoint is called and by whom
  * **Restrict access:** Limit this API call to admin-level accounts only
  * **Schedule carefully:** Use during off-peak hours when possible
  * **Alternative approach:** Consider terminating conferences individually when selective control is needed
</Tip>

### Example: Safe Implementation with Confirmation

```javascript JavaScript with Confirmation theme={null}
async function hangUpAllConferences() {
  // Step 1: Get list of active conferences
  const listResponse = await fetch(
    'https://api.vobiz.ai/api/v1/Account/{auth_id}/Conference/',
    {
      headers: {
        'X-Auth-ID': '{auth_id}',
        'X-Auth-Token': 'YOUR_AUTH_TOKEN'
      }
    }
  );

  const { conferences } = await listResponse.json();

  // Step 2: Show confirmation
  if (conferences.length === 0) {
    console.log('No active conferences to terminate');
    return;
  }

  const confirmed = confirm(
    `WARNING: This will terminate ${conferences.length} active conferences.\n` +
    `Conferences: ${conferences.join(', ')}\n\n` +
    'All participants will be disconnected immediately.\n' +
    'This action cannot be undone.\n\n' +
    'Are you sure you want to continue?'
  );

  if (!confirmed) {
    console.log('Operation cancelled by user');
    return;
  }

  // Step 3: Log the operation
  console.log('Terminating all conferences:', conferences);

  // Step 4: Execute termination
  const response = await fetch(
    'https://api.vobiz.ai/api/v1/Account/{auth_id}/Conference/',
    {
      method: 'DELETE',
      headers: {
        'X-Auth-ID': '{auth_id}',
        'X-Auth-Token': 'YOUR_AUTH_TOKEN'
      }
    }
  );

  if (response.status === 204) {
    console.log(`Successfully terminated ${conferences.length} conferences`);
  }
}

// Usage: Call with extreme caution
// hangUpAllConferences();
```

<Info>
  **Alternative: Selective Termination**

  If you need more control, consider terminating conferences individually using the [Hang Up a Conference](/conference/hang-up-conference) endpoint. This allows you to selectively terminate specific conferences while leaving others active.
</Info>


## OpenAPI

````yaml DELETE /api/v1/Account/{auth_id}/Conference/
openapi: 3.0.3
info:
  title: Vobiz API
  description: >
    The Vobiz API lets you make calls, manage phone numbers, configure SIP
    trunks, 

    and access account data programmatically.


    **Base URL:** `https://api.vobiz.ai`


    **Authentication:** All requests require `X-Auth-ID` and `X-Auth-Token`
    headers.

    Obtain these from your [Vobiz Console](https://console.vobiz.ai).
  version: '1.0'
  contact:
    email: support@vobiz.ai
    url: https://vobiz.ai
servers:
  - url: https://api.vobiz.ai
    description: Production
security:
  - AuthID: []
    AuthToken: []
tags:
  - name: Account
    description: Manage your account details and credentials
  - name: Balance
    description: Retrieve balance and transaction history
  - name: Calls
    description: Make and manage outbound calls
  - name: Live Calls
    description: Retrieve and control in-progress calls
  - name: CDR
    description: Call detail records and history
  - name: Sub-Accounts
    description: Create and manage sub-accounts
  - name: Phone Numbers
    description: Manage phone numbers on your account
  - name: Trunks
    description: Configure SIP trunks for inbound and outbound calling
  - name: Conference
    description: Manage conference calls and members
  - name: Applications
    description: Manage voice and messaging applications with webhook URLs
  - name: Endpoints
    description: Manage SIP endpoints for IP phones, softphones, and SIP clients
  - name: Partner API
    description: >-
      Reseller and white-label endpoints for managing customer sub-accounts,
      balance transfers, transactions, CDRs, and DIDs across your partner
      ecosystem
  - name: Sub-Account KYC
    description: >-
      Per-sub-account KYC verification (PAN, GST, CIN, Aadhaar, DigiLocker) and
      hosted email/redirect KYC sessions. Authenticated as the parent main
      account.
  - name: Sub-Account KYC (Test Mode)
    description: >-
      Mock KYC endpoints that never call the upstream provider. Drive verified /
      failed / pending / error outcomes with magic inputs for integration
      testing.
paths:
  /api/v1/Account/{auth_id}/Conference/:
    delete:
      tags:
        - Conferences
      summary: Delete all conferences
      description: Terminate all active conference rooms.
      operationId: delete-all-conferences
      parameters:
        - $ref: '#/components/parameters/AuthId'
      responses:
        '204':
          description: All conferences terminated
components:
  parameters:
    AuthId:
      name: auth_id
      in: path
      required: true
      description: Your account Auth ID
      schema:
        type: string
        example: MA_XXXXXX
  securitySchemes:
    AuthID:
      type: apiKey
      in: header
      name: X-Auth-ID
      description: Your Vobiz account Auth ID
    AuthToken:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: Your Vobiz account Auth Token

````