Delete Call

Owned by Kiss, Mate
May 24, 2022
2 min read

Overview

Deletes a conversation or marks an ongoing conversation for deletion.

The function is available as an HTTP GET or HTTP POST request.

Request

Delete Call:

http://<host>/verba/api?action=DeleteCall

Delete Call HTTP GET sample:

http://192.168.1.104/verba/api?action=DeleteCall&apiKey=74c8eea0-50c6-40b2-9f3e-252ed501c3c8&token=09835e02-6c10-11e0-bb22-ba324924019b&responseType=XML&extension=8856&status=last

Detailed description of the API request elements:

URL parameterParameter example

Description

Requirements
actionaction=DeleteCallName of the HTTP API request.Mandatory
apiKeyapiKey=74c8eea0-50c6-40b2-9f3e-252ed501c3c8API key used to identify the application.Mandatory
tokentoken=09835e02-6c10-11e0-bb22-ba324924019bUnique identifier for authenticated sessions. After successful authentication, the API sends back a token, which has to be used for each request.Mandatory if authentication is configured for the given API key.
responseTyperesponseType=XML

Defines the format of the response of the API request. The following valid values apply:

  • XML: the response is formatted and structured in XML, designed for applications
  • HTML: the response is in human-readable format and formatted using standard HTML; it can be directly displayed in any browser.
  • TEXT: simple clear text based response
If the parameter is missing, it defaults to XML.
callIDcallID=a8343631-9f35-4a3a-83f0-9e81592339fbDefines the internal ID of the call.Either callID, platformCallID, nativeID, meetingID or extension parameter is mandatory
platformCallIDplatformCallID=71627389The value of the Platform Call ID field.
nativeIDnativeID=TRS26140192The value of the Technical Call Identifier field.
meetingIDmeetingID=WHBFM6DDThe Lync Meeting ID.
extensionextension=8856Defines the phone number that is a participant of the call. The API will look for a call with the status defined, where the number is either the calling party or the called party. If the API, for some reason, finds more than 1 record, it will respond with error.
statusstatus=last

Defines the status of the requested call. Comma-separated values can be specified. The following valid values and value combinations apply:

  • ongoing - the API will look for an ongoing call, where the number is either the calling party or the called party
  • next - the API will look for the next call in the upcoming 1 minute time range after the API request, where the number is either the calling party or the called party
  • last - the API will look for the last finished call, where the number is either the calling party or the called party
  • ongoing, next - the API will look for an ongoing call, where the number is either the calling party or the called party; if no record was found, the API will look for the next call in the upcoming 1 minute time range after the API request, where the number is either the calling party or the called party
  • last, ongoing - the API will look for the last finished call, where the number is either the calling party or the called party; if no record was found, the API will look for an ongoing call, where the number is either the calling party or the called party
Mandatory if the extension parameter is specified

Response

XML based response sample on success:

<?xml version="1.0" encoding="UTF-8"?>

<VerbaApi>

<Response code="0" type="DeleteCall" />

</VerbaApi>

XML based response sample on error:

<?xml version="1.0" encoding="UTF-8"?>

<VerbaApi>

<Response code="-50" type="DeleteCall">

<ErrorMessage>Call for extension 3123212312 with status ongoing not found after 2 tries, with sleep time 1000.</ErrorMessage>

</Response>

</VerbaApi>