> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# stop_stream

> Stop an active audio stream.

Stop an audio stream started with [`stream`](/docs/swml/reference/calling/stream). By default it stops the most recently started stream; pass a `control_id` to stop a specific one.

## **Properties**

An object that accepts the following properties.

The control ID of the stream to stop, as assigned when you started it with `stream`.

## **Variables**

Read by the method. Control ID of the most recently started stream.

Set by the method. Whether the stream stopped successfully.

## **Examples**

### Stop the last stream

```yaml
version: 1.0.0
sections:
  main:
    - stop_stream: {}
```

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "stop_stream": {}
      }
    ]
  }
}
```

### Stop a specific stream

```yaml
version: 1.0.0
sections:
  main:
    - stop_stream:
        control_id: my-stream-id
```

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "stop_stream": {
          "control_id": "my-stream-id"
        }
      }
    ]
  }
}
```