Request erasure of all data for an identity
curl --request DELETE \
--url https://api.immutable.com/v1/audience/data \
--header 'x-immutable-api-key: <api-key>'import requests
url = "https://api.immutable.com/v1/audience/data"
headers = {"x-immutable-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-immutable-api-key': '<api-key>'}};
fetch('https://api.immutable.com/v1/audience/data', 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.immutable.com/v1/audience/data",
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-immutable-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://api.immutable.com/v1/audience/data"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-immutable-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://api.immutable.com/v1/audience/data")
.header("x-immutable-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.immutable.com/v1/audience/data")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-immutable-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "VALIDATION_ERROR",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "UNAUTHORISED_REQUEST",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "INTERNAL_SERVER_ERROR",
"details": {}
}data
Request erasure of all data for an identity
Accepts an erasure request for the specified identity. All linked identities are resolved via stored alias mappings and an erasure event is queued for async processing. Provide either anonymousId or userId (not both).
Requires the project’s secret API key, not the publishable key: this deletes another identity’s data on the project’s behalf, which a client holding only the (public) publishable key can never safely authorize.
DELETE
/
v1
/
audience
/
data
Request erasure of all data for an identity
curl --request DELETE \
--url https://api.immutable.com/v1/audience/data \
--header 'x-immutable-api-key: <api-key>'import requests
url = "https://api.immutable.com/v1/audience/data"
headers = {"x-immutable-api-key": "<api-key>"}
response = requests.delete(url, headers=headers)
print(response.text)const options = {method: 'DELETE', headers: {'x-immutable-api-key': '<api-key>'}};
fetch('https://api.immutable.com/v1/audience/data', 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.immutable.com/v1/audience/data",
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-immutable-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://api.immutable.com/v1/audience/data"
req, _ := http.NewRequest("DELETE", url, nil)
req.Header.Add("x-immutable-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://api.immutable.com/v1/audience/data")
.header("x-immutable-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.immutable.com/v1/audience/data")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(url)
request["x-immutable-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "VALIDATION_ERROR",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "UNAUTHORISED_REQUEST",
"details": {}
}{
"message": "all fields must be provided",
"link": "https://docs.immutable.com",
"trace_id": "e47634b79a5cd6894ddc9639ec4aad26",
"code": "INTERNAL_SERVER_ERROR",
"details": {}
}Was this page helpful?
⌘I