1. Telebroad | Support Center
  2. Solution home
  3. Legacy API Documentation
  4. REST API - POST Requests
Open navigation

POST/call/hangup (Legacy)

   Articles in this support section discuss Telebroad's legacy APIs. To learn about the current version of Telebroad APIs, which offer additional authentication options and support for advanced features, please go to https://developers.telebroad.com/.



The POST/call/hangup method ends a specific call. For this method to work, the call to be hung up must be placed using the POST/send/call method, in order to identify the call with a unique ID. 


Parameters


There are no parameters in the header. All parameters go in the body in JSON Raw format.


ParameterTypeOperation
callidstringA unique ID number for the call. This needs to be obtained from the callid field in the response received from the post/send/call method, once the call is placed from that method. 

Example


To hang up a call with a callid of 1519784628.70134037 use this syntax:


HTTPS method: POST


Header


webserv.telebroad.com/api/teleconsole/rest/call/hangup


Body


{"callid":"1519784628.70134037"}


Response:


If the call was hung up successfully:


{

    "error": null,

    "result": "1"

}


If there was a problem hanging up the call (usually due to the wrong callid or if the call has already ended):


{

    "error":{

        "code": 444,

        "message": "The call does not exist."

    }

}