Decline an incoming call

If the user does not want to answer an incoming call, then they can decline it on their device. After that, this request is sent. Once declined, the call continues on other devices.

POST /api/v1/intercom/calls/{call}/cancel

Parameters

int call, ID of the call to be declined (status should be ring)

204 No Content

Successful response

401 Unauthorized

Authorization token not sent or not valid

404 Not Found

If the call does not belong to the user, does not exist or is not in ring status

cURL

BASH

curl -k --request POST \
	--url 'https://your-domain/api/v1/intercom/calls/{call}/cancel' \
	--header 'Content-Type: application/json' \
	--header 'Accept: application/json' \
	--data '{
    "call": 0
}'

PHP

$data = array (
  'call' => 0,
);
$context = stream_context_create([
	'ssl'=>['verify_peer' => false],
	'http' => [
		'method' => 'POST',
		'header' => "Content-Type: application/json\r
Accept: application/json",
		'content'=>json_encode($data)
	]
]);
$result = file_get_contents('https://your-domain/api/v1/intercom/calls/{call}/cancel', false, $context);