Delete contact
curl --request DELETE \
--url https://api.telli.com/v2/contacts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.telli.com/v2/contacts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.telli.com/v2/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.telli.com/v2/contacts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.telli.com/v2/contacts/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.telli.com/v2/contacts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telli.com/v2/contacts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body"<unknown>"{
"defined": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "API key is missing or invalid",
"data": "<unknown>"
}{
"defined": true,
"code": "PAYMENT_REQUIRED",
"status": 402,
"message": "API access requires a paid plan",
"data": "<unknown>"
}{
"defined": true,
"code": "CONTACT_NOT_FOUND",
"status": 404,
"message": "Contact not found",
"data": {
"contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"defined": true,
"code": "CONTACT_HAS_PENDING_CALLS",
"status": 409,
"message": "A call for this contact is still being processed. Please wait for all calls to complete before deleting.",
"data": {
"contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Contact Endpoints
Delete Contact
Deletes a contact and all personal data telli stores for it, including the recordings, transcripts, and analyses of its calls. The deletion cannot be undone.
DELETE
/
v2
/
contacts
/
{id}
Delete contact
curl --request DELETE \
--url https://api.telli.com/v2/contacts/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.telli.com/v2/contacts/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.telli.com/v2/contacts/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.telli.com/v2/contacts/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.telli.com/v2/contacts/{id}"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://api.telli.com/v2/contacts/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.telli.com/v2/contacts/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body"<unknown>"{
"defined": true,
"code": "UNAUTHORIZED",
"status": 401,
"message": "API key is missing or invalid",
"data": "<unknown>"
}{
"defined": true,
"code": "PAYMENT_REQUIRED",
"status": 402,
"message": "API access requires a paid plan",
"data": "<unknown>"
}{
"defined": true,
"code": "CONTACT_NOT_FOUND",
"status": 404,
"message": "Contact not found",
"data": {
"contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}{
"defined": true,
"code": "CONTACT_HAS_PENDING_CALLS",
"status": 409,
"message": "A call for this contact is still being processed. Please wait for all calls to complete before deleting.",
"data": {
"contactId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
}Deleting a contact removes all personal data telli stores about the person, including the recordings, transcripts, and analyses of its calls. See Deleting Contacts and Personal Data for what is deleted and what remains.
Was this page helpful?