***

id: 3a19812b-f53c-4043-a745-71d93128eaac
title: stop\_record\_call
slug: /reference/stop-record-call
description: Stop an active background recording.
max-toc-depth: 3
----------------

Stop an active background recording.

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

## **Properties**

<ParamField path="stop_record_call.control_id" type="string" default="The last started recording will be stopped" toc={true}>
  Identifier for the recording to stop
</ParamField>

## **Variables**

Read by the method:

* **record\_control\_id:** (in) control ID of last recording started.

Set by the method:

* **stop\_record\_call\_result:** (out) `success` | `failed`

## **Examples**

### Stop last call recording

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

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

### Stop a specific call recording

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

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