> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# hangup

> Ends the call.

End the call with an optional reason.

## **Properties**

**`hangup`** `object` — required

An object that accepts the following properties.

---

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

## **Examples**

### No parameters

#### YAML

```yaml
version: 1.0.0
sections:
  main:
    - answer: {}
    - hangup: {}
```

#### JSON

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

### Set a hangup reason

#### YAML

```yaml
version: 1.0.0
sections:
  main:
    - answer: {}
    - hangup:
        reason: "busy"
```

#### JSON

```json
{
  "version": "1.0.0",
  "sections": {
    "main": [
      {
        "answer": {}
      },
      {
        "hangup": {
          "reason": "busy"
        }
      }
    ]
  }
}
```

> Ends the call.