API
Hang up a call
Ends the call, or declines it while it rings. Hanging up an ended call is not an error.
POST
Ends the call, or declines it while it rings. Hanging up an ended call is not an error.
header
AuthorizationBearer <token>Your API key, 06l_…. For servers only.
call_id*stringMatch
^call_[0-9a-z]{26}$Ended.
application/json- response
id*CallIdMatch
^call_[0-9a-z]{26}$line_id*LineIdMatch
^line_[0-9a-z]{26}$direction*stringValue in
"outbound""inbound"from*PhoneNumberE.164, e.g. +33612345678.
Match
^\+[1-9][0-9]{6,14}$to*PhoneNumberE.164, e.g. +33612345678.
Match
^\+[1-9][0-9]{6,14}$state*stringdialing → ringing → active → ended. Incoming calls start at ringing.
Value in
"dialing""ringing""active""ended"end_reason?stringValue in
"hangup""remote_hangup""no_answer""busy""failed""line_offline"client_ref?ClientRefYour own identifier. Sending the same client_ref twice returns the first result instead of acting twice.
Length
length <= 255created_by*Who did it. user from the 06 Line dashboard, api_key from your code, agent for what the network sent you, system for 06 Line itself.
started_at*TimestampRFC 3339, UTC.
Format
date-timeanswered_at?TimestampRFC 3339, UTC.
Format
date-timeended_at?TimestampRFC 3339, UTC.
Format
date-timeduration_s?integerTalk time, from answered_at to ended_at.
curl -X POST 'https://api.06line.com/v1/calls/string/hangup'Example Response
{ "id": "string", "line_id": "string", "direction": "outbound", "from": "string", "to": "string", "state": "dialing", "end_reason": "hangup", "client_ref": "string", "created_by": { "type": "user", "id": "string" }, "started_at": "2019-08-24T14:15:22Z", "answered_at": "2019-08-24T14:15:22Z", "ended_at": "2019-08-24T14:15:22Z", "duration_s": 0}