Hang up
hang_upEnd a call you placed. In an open conversation goodbye is spoken
first; leave it empty to just hang up. A call that already ended reports
its final status.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"call_id": "<call_id>",
"session_token": "<session_token>"
},
"name": "hang_up"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| call_id | Yes | The call_id from the call or play_audio result. | |
| goodbye | No | Spoken before the line drops in an open conversation, e.g. "Thanks, I'll get on it." Empty just hangs up. | |
| session_token | Yes | The session_token from an earlier result. It keeps every call and text in one thread on their phone. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| open | No | Always false: the line is down. | |
| status | Yes | "ended", or "hanging_up" while the goodbye is spoken. | |
| call_id | No | The call that was ended. | |
| session_token | No | This session's token. |