channel request hangup

Since N/A CLI Commands Found this useful? Upvote it. ×

Request that one or more channels be hung up.

Last reviewed 2026-07-02

channel request hangup <all>|<channel> [<channel> ...]
Description

Request that one or more channels be hung up. The hangup takes effect the next time the driver reads or writes from the channel.

If 'all' is specified instead of a channel name, all channels will see the hangup request.

A POSIX Extended Regular Expression can be provided in the place of a fixed channel name by wrapping it in forward slashes (e.g. /^PJSIP.*/). Note that the expression will match any part of the channel name unless anchored explicitly by ^ and/or $.

Finally, wildcards () and other glob-like characters can also be used to match more than one channel. Similar to how path globs behave, a forward slash cannot be matched with a wildcard or bracket expression. In other words, if you want to hangup all Local channels, you must specify Local/ and not Loc*.

User Notes

Know a tip or gotcha for this topic? Share it below and help others.

Contribute a note

Share a tip, gotcha, or practical example. Keep it under 2000 characters. No questions (use the Asterisk community forums for support). Wrap code in backticks.

Moderated before publishing. Email never shown.

Related

xmpp show connections

Shows state of client and component connections

CLI Commands cli
xmpp show buddies

Shows buddy lists of our clients

CLI Commands cli
xmpp set debug {on|off}

Enables/disables dumping of XMPP/Jabber packets for debugging purposes.

CLI Commands cli
xmpp purge nodes

Purges nodes on PubSub server as configured in xmpp.conf.

CLI Commands cli
xmpp list nodes

Lists the user's nodes on the respective connection ([connection] as configured in xmpp.conf.)

CLI Commands cli
CLI Commands
! CLI Commands Quick Reference _command matchesarray acl show aeap show client aeap show clients ael reload ael set debug {read|tokens|contexts|off} agent logoff agent show agent show all agent show online agi dump html agi exec agi set debug [on|off] agi show commands [topic] aoc set debug ari mkpasswd ari set debug ari show app ari show apps ari show outbound-websocket ari show outbound-websockets ari show status ari show user ari show users ari show websocket sessions ari shutdown websocket session ari shutdown websocket sessions ari start outbound-websocket astobj2 container check astobj2 container dump astobj2 container stats astobj2 show stats astobj2 test bridge destroy bridge kick bridge show bridge show all bridge technology show bridge technology {suspend|unsuspend} calendar dump sched calendar show calendar calendar show calendars calendar show types cc cancel [core|all] cc report status cdr set debug [on|off] cdr show active cdr show pgsql status cdr show status cdr submit cel show status channel dump frames channel originate channel redirect channel request hangup cli check permissions cli reload permissions cli show aliases cli show permissions confbridge kick confbridge list confbridge lock confbridge mute confbridge record start confbridge record stop confbridge show menu confbridge show menus confbridge show profile bridge confbridge show profile bridges confbridge show profile user confbridge show profile users confbridge unlock confbridge unmute config list config reload config show help console answer console dial console flash console hangup console list available console list devices console send text console {mute|unmute} console {set|show} active console {set|show} autoanswer [on|off] core abort shutdown core clear profile core eat memory core ping taskprocessor core reload core reset taskprocessor core reset taskprocessors core restart gracefully core restart now core restart when convenient core set debug core set debug category core set debug channel core set trace core set verbose core show application core show applications [like|describing] core show calls [uptime] core show channel core show channels [concise|verbose|count] core show channeltype core show channeltypes core show codec core show codecs [audio|video|image|text] core show config mappings core show device2extenstate core show fd core show file formats core show function core show functions [like] core show hanguphandlers core show hanguphandlers all core show help core show hint core show hints core show image formats core show license core show locks core show profile core show settings core show sound core show sounds core show switches core show sysinfo core show taskprocessor alerted subsystems core show taskprocessor name core show taskprocessors [like] core show threads core show translation core show uptime [seconds] core show version core show warranty core stop gracefully core stop now core stop when convenient core waitfullybooted corosync ping corosync show config corosync show members dahdi create channels dahdi destroy channels dahdi restart dahdi set dnd dahdi set hwgain {rx|tx} dahdi set mwi dahdi set swgain {rx|tx} dahdi show cadences dahdi show channel dahdi show channels [group|context] dahdi show status dahdi show version database del database deltree database get database put database query database show database showkey devstate change devstate list dialplan add extension dialplan add ignorepat dialplan add include dialplan debug dialplan eval function dialplan exec application dialplan locks show dialplan reload dialplan remove context dialplan remove extension dialplan remove ignorepat dialplan remove include dialplan save dialplan set chanvar dialplan set extenpatternmatchnew false dialplan set extenpatternmatchnew true dialplan set global dialplan show dialplan show chanvar dialplan show globals dnsmgr refresh dnsmgr reload dnsmgr status dundi flush [stats] dundi lookup dundi precache dundi query dundi set debug {on|off} dundi show cache dundi show entityid dundi show hints dundi show mappings dundi show peer dundi show peers [registered|include|exclude|begin] dundi show precache dundi show requests dundi show trans dundi store history {on|off} fax set debug {on|off} fax show capabilities fax show session fax show sessions fax show settings fax show stats fax show version features show file convert geoloc list locations geoloc list profiles geoloc reload geoloc show gml_shape_defs geoloc show profiles group show channels http show status iax2 provision iax2 prune realtime iax2 reload iax2 set debug jb {on|off} iax2 set debug trunk {on|off} iax2 set debug {on|off|peer} iax2 set mtu iax2 show cache iax2 show callnumber usage iax2 show channels iax2 show firmware iax2 show netstats iax2 show peer iax2 show peers iax2 show provisioning iax2 show registry iax2 show stats iax2 show threads iax2 show users [like] iax2 test jitter iax2 test late iax2 test losspct iax2 test resync iax2 unregister indication add indication remove indication show keys init keys show local show channels logger add channel logger filter changroup logger filter reset logger filter show logger mute logger reload logger remove channel logger rotate logger set level {DEBUG|TRACE|NOTICE|WARNING|ERROR|VERBOSE|DTMF} {on|off} logger show channels logger show levels malloc trim manager kick session manager reload manager set debug [on|off] manager show command manager show commands manager show connected manager show event manager show eventq manager show events manager show settings manager show user manager show users media cache create media cache delete media cache refresh media cache show media cache show all meetme kick meetme list meetme {lock|unlock} meetme {mute|unmute} memory atexit list {on|off} memory atexit summary {off|byline|byfunc|byfile} memory backtrace {on|off} memory show allocations memory show summary mfcr2 call files [on|off] mfcr2 destroy link mfcr2 set blocked mfcr2 set debug mfcr2 set idle mfcr2 show channels [group|context] mfcr2 show links mfcr2 show variants mfcr2 show version minivm list accounts [for] minivm list templates minivm list zones minivm reload minivm show settings minivm show stats mixmonitor {start|stop|list} mobile cusd mobile rfcomm mobile search mobile show devices module load module refresh module reload module show [like] module unload moh reload moh show classes moh show files moh unregister class mwi delete all mwi delete like mwi delete mailbox mwi list all mwi list like mwi show mailbox mwi update mailbox odbc read odbc show odbc write ooh323 reload ooh323 set debug [off] ooh323 show config ooh323 show gk ooh323 show peer ooh323 show peers ooh323 show user ooh323 show users parking show phoneprov show routes pjproject set log level {default|0|1|2|3|4|5|6} pjproject show buildopts pjproject show log level pjproject show log mappings pjsip dump endpt [details] pjsip export config_wizard primitives [to] pjsip list ciphers pjsip list subscriptions {inbound|outbound} [like] pjsip qualify pjsip reload qualify aor pjsip reload qualify endpoint pjsip send notify pjsip send register pjsip send unregister pjsip set history {on|off|clear} pjsip set logger {on|off|host|add|method|methodadd|verbose|pcap} pjsip show history pjsip show identifiers pjsip show qualify aor pjsip show qualify endpoint pjsip show scheduled_tasks pjsip show settings pjsip show subscription {inbound|outbound} pjsip show subscriptions {inbound|outbound} [like] pjsip show transport-monitors pjsip show version presencestate change presencestate list pri destroy span pri service disable channel pri service enable channel pri set debug file pri set debug {on|off|hex|intense|0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15} span pri show channels pri show debug pri show span pri show spans pri show version prometheus show metrics prometheus show status queue add member queue priority caller queue reload {parameters|members|rules|all} queue remove member queue reset stats queue set penalty queue set ringinuse queue show queue show rules queue {pause|unpause} member realtime destroy realtime load realtime mysql cache realtime mysql status realtime show ldap status realtime show pgsql cache realtime show pgsql status realtime store realtime update realtime update2 remb set {send|receive} rtcp set debug {on|off|ip} rtcp set stats {on|off} rtp drop rtp set debug {on|off|ip} rtp show settings say load [new|old] skel show config skel show games skel show levels sla show stations sla show trunks sorcery memory cache dump sorcery memory cache expire sorcery memory cache populate sorcery memory cache show sorcery memory cache stale sorcery show settings ss7 mtp3 ss7 reset cic ss7 reset group ss7 restart mtp3 ss7 set debug {on|off} linkset ss7 show calls ss7 show channels ss7 show cics ss7 show linkset ss7 show version ss7 {block|unblock} cic ss7 {block|unblock} group ss7 {reset|block|unblock} linkset stasis show topic stasis show topics stasis statistics show messages stasis statistics show subscription stasis statistics show subscriptions stasis statistics show topic stasis statistics show topics stir_shaken show attestation stir_shaken show eprofile stir_shaken show eprofiles stir_shaken show profile stir_shaken show profiles stir_shaken show tn stir_shaken show tns stir_shaken show verification stir_shaken verify certificate_file stun set debug {on|off} stun show status test execute test generate results test show registered test show results threadstorage show allocations threadstorage show summary timing test transcoder show udptl set debug {on|off|ip} udptl show config ulimit unistim reload unistim send packet unistim set debug {on|off} unistim show devices unistim show info voicemail forward voicemail move voicemail reload voicemail remove voicemail show aliases voicemail show mailbox voicemail show users [for] voicemail show zones xmldoc dump xmldoc reload xmpp create collection xmpp create leaf xmpp delete node xmpp list nodes xmpp purge nodes xmpp set debug {on|off} xmpp show buddies xmpp show connections
CLI Commands
! CLI Commands Quick Reference _command matchesarray acl show aeap show client aeap show clients ael reload ael set debug {read|tokens|contexts|off} agent logoff agent show agent show all agent show online agi dump html agi exec agi set debug [on|off] agi show commands [topic] aoc set debug ari mkpasswd ari set debug ari show app ari show apps ari show outbound-websocket ari show outbound-websockets ari show status ari show user ari show users ari show websocket sessions ari shutdown websocket session ari shutdown websocket sessions ari start outbound-websocket astobj2 container check astobj2 container dump astobj2 container stats astobj2 show stats astobj2 test bridge destroy bridge kick bridge show bridge show all bridge technology show bridge technology {suspend|unsuspend} calendar dump sched calendar show calendar calendar show calendars calendar show types cc cancel [core|all] cc report status cdr set debug [on|off] cdr show active cdr show pgsql status cdr show status cdr submit cel show status channel dump frames channel originate channel redirect channel request hangup cli check permissions cli reload permissions cli show aliases cli show permissions confbridge kick confbridge list confbridge lock confbridge mute confbridge record start confbridge record stop confbridge show menu confbridge show menus confbridge show profile bridge confbridge show profile bridges confbridge show profile user confbridge show profile users confbridge unlock confbridge unmute config list config reload config show help console answer console dial console flash console hangup console list available console list devices console send text console {mute|unmute} console {set|show} active console {set|show} autoanswer [on|off] core abort shutdown core clear profile core eat memory core ping taskprocessor core reload core reset taskprocessor core reset taskprocessors core restart gracefully core restart now core restart when convenient core set debug core set debug category core set debug channel core set trace core set verbose core show application core show applications [like|describing] core show calls [uptime] core show channel core show channels [concise|verbose|count] core show channeltype core show channeltypes core show codec core show codecs [audio|video|image|text] core show config mappings core show device2extenstate core show fd core show file formats core show function core show functions [like] core show hanguphandlers core show hanguphandlers all core show help core show hint core show hints core show image formats core show license core show locks core show profile core show settings core show sound core show sounds core show switches core show sysinfo core show taskprocessor alerted subsystems core show taskprocessor name core show taskprocessors [like] core show threads core show translation core show uptime [seconds] core show version core show warranty core stop gracefully core stop now core stop when convenient core waitfullybooted corosync ping corosync show config corosync show members dahdi create channels dahdi destroy channels dahdi restart dahdi set dnd dahdi set hwgain {rx|tx} dahdi set mwi dahdi set swgain {rx|tx} dahdi show cadences dahdi show channel dahdi show channels [group|context] dahdi show status dahdi show version database del database deltree database get database put database query database show database showkey devstate change devstate list dialplan add extension dialplan add ignorepat dialplan add include dialplan debug dialplan eval function dialplan exec application dialplan locks show dialplan reload dialplan remove context dialplan remove extension dialplan remove ignorepat dialplan remove include dialplan save dialplan set chanvar dialplan set extenpatternmatchnew false dialplan set extenpatternmatchnew true dialplan set global dialplan show dialplan show chanvar dialplan show globals dnsmgr refresh dnsmgr reload dnsmgr status dundi flush [stats] dundi lookup dundi precache dundi query dundi set debug {on|off} dundi show cache dundi show entityid dundi show hints dundi show mappings dundi show peer dundi show peers [registered|include|exclude|begin] dundi show precache dundi show requests dundi show trans dundi store history {on|off} fax set debug {on|off} fax show capabilities fax show session fax show sessions fax show settings fax show stats fax show version features show file convert geoloc list locations geoloc list profiles geoloc reload geoloc show gml_shape_defs geoloc show profiles group show channels http show status iax2 provision iax2 prune realtime iax2 reload iax2 set debug jb {on|off} iax2 set debug trunk {on|off} iax2 set debug {on|off|peer} iax2 set mtu iax2 show cache iax2 show callnumber usage iax2 show channels iax2 show firmware iax2 show netstats iax2 show peer iax2 show peers iax2 show provisioning iax2 show registry iax2 show stats iax2 show threads iax2 show users [like] iax2 test jitter iax2 test late iax2 test losspct iax2 test resync iax2 unregister indication add indication remove indication show keys init keys show local show channels logger add channel logger filter changroup logger filter reset logger filter show logger mute logger reload logger remove channel logger rotate logger set level {DEBUG|TRACE|NOTICE|WARNING|ERROR|VERBOSE|DTMF} {on|off} logger show channels logger show levels malloc trim manager kick session manager reload manager set debug [on|off] manager show command manager show commands manager show connected manager show event manager show eventq manager show events manager show settings manager show user manager show users media cache create media cache delete media cache refresh media cache show media cache show all meetme kick meetme list meetme {lock|unlock} meetme {mute|unmute} memory atexit list {on|off} memory atexit summary {off|byline|byfunc|byfile} memory backtrace {on|off} memory show allocations memory show summary mfcr2 call files [on|off] mfcr2 destroy link mfcr2 set blocked mfcr2 set debug mfcr2 set idle mfcr2 show channels [group|context] mfcr2 show links mfcr2 show variants mfcr2 show version minivm list accounts [for] minivm list templates minivm list zones minivm reload minivm show settings minivm show stats mixmonitor {start|stop|list} mobile cusd mobile rfcomm mobile search mobile show devices module load module refresh module reload module show [like] module unload moh reload moh show classes moh show files moh unregister class mwi delete all mwi delete like mwi delete mailbox mwi list all mwi list like mwi show mailbox mwi update mailbox odbc read odbc show odbc write ooh323 reload ooh323 set debug [off] ooh323 show config ooh323 show gk ooh323 show peer ooh323 show peers ooh323 show user ooh323 show users parking show phoneprov show routes pjproject set log level {default|0|1|2|3|4|5|6} pjproject show buildopts pjproject show log level pjproject show log mappings pjsip dump endpt [details] pjsip export config_wizard primitives [to] pjsip list ciphers pjsip list subscriptions {inbound|outbound} [like] pjsip qualify pjsip reload qualify aor pjsip reload qualify endpoint pjsip send notify pjsip send register pjsip send unregister pjsip set history {on|off|clear} pjsip set logger {on|off|host|add|method|methodadd|verbose|pcap} pjsip show history pjsip show identifiers pjsip show qualify aor pjsip show qualify endpoint pjsip show scheduled_tasks pjsip show settings pjsip show subscription {inbound|outbound} pjsip show subscriptions {inbound|outbound} [like] pjsip show transport-monitors pjsip show version presencestate change presencestate list pri destroy span pri service disable channel pri service enable channel pri set debug file pri set debug {on|off|hex|intense|0|1|2|3|4|5|6|7|8|9|10|11|12|13|14|15} span pri show channels pri show debug pri show span pri show spans pri show version prometheus show metrics prometheus show status queue add member queue priority caller queue reload {parameters|members|rules|all} queue remove member queue reset stats queue set penalty queue set ringinuse queue show queue show rules queue {pause|unpause} member realtime destroy realtime load realtime mysql cache realtime mysql status realtime show ldap status realtime show pgsql cache realtime show pgsql status realtime store realtime update realtime update2 remb set {send|receive} rtcp set debug {on|off|ip} rtcp set stats {on|off} rtp drop rtp set debug {on|off|ip} rtp show settings say load [new|old] skel show config skel show games skel show levels sla show stations sla show trunks sorcery memory cache dump sorcery memory cache expire sorcery memory cache populate sorcery memory cache show sorcery memory cache stale sorcery show settings ss7 mtp3 ss7 reset cic ss7 reset group ss7 restart mtp3 ss7 set debug {on|off} linkset ss7 show calls ss7 show channels ss7 show cics ss7 show linkset ss7 show version ss7 {block|unblock} cic ss7 {block|unblock} group ss7 {reset|block|unblock} linkset stasis show topic stasis show topics stasis statistics show messages stasis statistics show subscription stasis statistics show subscriptions stasis statistics show topic stasis statistics show topics stir_shaken show attestation stir_shaken show eprofile stir_shaken show eprofiles stir_shaken show profile stir_shaken show profiles stir_shaken show tn stir_shaken show tns stir_shaken show verification stir_shaken verify certificate_file stun set debug {on|off} stun show status test execute test generate results test show registered test show results threadstorage show allocations threadstorage show summary timing test transcoder show udptl set debug {on|off|ip} udptl show config ulimit unistim reload unistim send packet unistim set debug {on|off} unistim show devices unistim show info voicemail forward voicemail move voicemail reload voicemail remove voicemail show aliases voicemail show mailbox voicemail show users [for] voicemail show zones xmldoc dump xmldoc reload xmpp create collection xmpp create leaf xmpp delete node xmpp list nodes xmpp purge nodes xmpp set debug {on|off} xmpp show buddies xmpp show connections