Permanently delete a response's data
curl --request DELETE \
--url https://listenlabs.ai/api/public/v1/responses \
--header 'x-api-key: <api-key>'import requests
url = "https://listenlabs.ai/api/public/v1/responses"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://listenlabs.ai/api/public/v1/responses', 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://listenlabs.ai/api/public/v1/responses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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://listenlabs.ai/api/public/v1/responses"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://listenlabs.ai/api/public/v1/responses")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://listenlabs.ai/api/public/v1/responses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deletionId": "de57d161-71a5-4e65-96e3-64b960a18ed2",
"responseId": "877e4c64-6804-4bcb-a3d8-99805068f643",
"status": "completed"
}Delete Response
Request permanent deletion of a response and receive a deletion receipt
DELETE
/
api
/
public
/
v1
/
responses
Permanently delete a response's data
curl --request DELETE \
--url https://listenlabs.ai/api/public/v1/responses \
--header 'x-api-key: <api-key>'import requests
url = "https://listenlabs.ai/api/public/v1/responses"
headers = {"x-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-api-key': '<api-key>'}};
fetch('https://listenlabs.ai/api/public/v1/responses', 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://listenlabs.ai/api/public/v1/responses",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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://listenlabs.ai/api/public/v1/responses"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.delete("https://listenlabs.ai/api/public/v1/responses")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://listenlabs.ai/api/public/v1/responses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"deletionId": "de57d161-71a5-4e65-96e3-64b960a18ed2",
"responseId": "877e4c64-6804-4bcb-a3d8-99805068f643",
"status": "completed"
}Pass both the
studyId and responseId UUIDs from Search Responses. Deletion runs asynchronously and removes respondent media and response-owned data.
The receipt contains deletionId, responseId, and status. A 202 means the deletion is queued or running; a 200 means an existing deletion is completed or failed. Repeating the request returns the same deletion ID and current status, including after the response is removed. Use Get Response Deletion Status to follow progress.