***

id: 7b39ae3a-293f-4217-b79c-92297fffa866
title: stop\_tap
slug: /reference/stop-tap
description: Stop an active tap stream.
max-toc-depth: 3
----------------

Stop an active tap stream.

<ParamField path="stop_tap" type="object" required={true} toc={true}>
  An object that accepts the following properties.
</ParamField>

## **Properties**

<ParamField path="stop_tap.control_id" type="string" default="The last tap started will be stopped" toc={true}>
  ID of the tap to stop
</ParamField>

## **Variables**

Read by the method:

* **tap\_control\_id:** (in) Control ID of last tap stream started.

Set by the method:

* **stop\_tap\_result:** (out) Success or failed.

## **Examples**

### Stop the last call tap

<CodeBlocks>
  <CodeBlock title="YAML">
    ```yaml
    version: 1.0.0
    sections:
      main:
        - stop_tap: {}
    ```
  </CodeBlock>

  <CodeBlock title="JSON">
    ```json
    {
      "version": "1.0.0",
      "sections": {
        "main": [
          {
            "stop_tap": {}
          }
        ]
      }
    }
    ```
  </CodeBlock>
</CodeBlocks>

### Stop a specific call tap

<CodeBlocks>
  <CodeBlock title="YAML">
    ```yaml
    version: 1.0.0
    sections:
      main:
        - stop_tap:
            control_id: my-tap-id
    ```
  </CodeBlock>

  <CodeBlock title="JSON">
    ```json
    {
      "version": "1.0.0",
      "sections": {
        "main": [
          {
            "stop_tap": {
              "control_id": "my-tap-id"
            }
          }
        ]
      }
    }
    ```
  </CodeBlock>
</CodeBlocks>