> ## 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.

# Stop a Specific Audio Stream

> Stop a single Vobiz audio stream by stream ID without affecting other active forks on the same call - triggers a Stream stopped status callback on close.

```http theme={null}
DELETE https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Stream/{stream_id}/
```

This endpoint stops streaming for a specific `stream_id` without affecting other streams that may be running on the same call. Once stopped, Vobiz closes the WebSocket connection for that stream and sends an `Event=StopStream` status callback if `status_callback_url` was configured.

<Note>
  This is the REST equivalent of sending a [`stop` WebSocket event](/xml/stream/stop-event) from your server. Both close the stream's WebSocket. The difference: a server-side `stop` event also advances the call to the next XML element (or hangs up). This REST `DELETE` ends the fork; the call itself continues unless it has nothing else keeping it alive.
</Note>

<Info>
  **Authentication required:**

  * `X-Auth-ID` - Your account Auth ID
  * `X-Auth-Token` - Your account Auth Token
</Info>

## Path parameters

| Field       | Type   | Required | Description               |
| ----------- | ------ | -------- | ------------------------- |
| `auth_id`   | string | Yes      | Your account ID.          |
| `call_uuid` | string | Yes      | UUID of the call.         |
| `stream_id` | string | Yes      | ID of the stream to stop. |

## Response

Returns **HTTP 204 No Content** on success. The body is empty.

A `404 Not Found` is returned if the `stream_id` is unknown, already stopped, or belongs to a different call. Treat stopping an already-stopped stream as idempotent in your code - the WebSocket may have already closed via caller hangup before your `DELETE` arrived.

```json Response - 404 Not Found theme={null}
{
    "api_id": "correlation-id-uuid",
    "error": "Stream not found"
}
```

## Example

```bash cURL theme={null}
curl -X DELETE 'https://api.vobiz.ai/api/v1/Account/{auth_id}/Call/{call_uuid}/Stream/{stream_id}/' \
  -H 'X-Auth-ID: {auth_id}' \
  -H 'X-Auth-Token: {auth_token}'
```


## OpenAPI

````yaml DELETE /api/v1/Account/{auth_id}/Call/{call_uuid}/Stream/{stream_id}/
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}/Call/{call_uuid}/Stream/{stream_id}/:
    delete:
      tags:
        - Audio Streams
      summary: Stop a stream
      description: Stop a specific audio stream on a live call.
      operationId: stop-stream
      parameters:
        - $ref: '#/components/parameters/AuthId'
        - name: call_uuid
          in: path
          required: true
          schema:
            type: string
        - name: stream_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '204':
          description: Stream stopped
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

````