***

id: 3680ef2d-f9db-4143-9f4f-7f2e55875a41
title: hangup
slug: /reference/hangup
description: Ends the call.
max-toc-depth: 3
----------------

End the call with an optional reason.

## **Properties**

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

**hangup.reason**
The reason for hanging up the call.

## **Examples**

### No parameters

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

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

### Set a hangup reason

<CodeBlocks>
  <CodeBlock title="YAML">
    ```yaml
    version: 1.0.0
    sections:
      main:
        - answer: {}
        - hangup:
            reason: "busy"
    ```
  </CodeBlock>

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