Export a help-desk requester's personal data (GDPR Art. 15)
curl --request POST \
--url https://api.amdital.com/v1/privacy/requesters/export \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "jsmith@example.com"
}
'import requests
url = "https://api.amdital.com/v1/privacy/requesters/export"
payload = { "email": "jsmith@example.com" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: 'jsmith@example.com'})
};
fetch('https://api.amdital.com/v1/privacy/requesters/export', 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.amdital.com/v1/privacy/requesters/export",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'jsmith@example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.amdital.com/v1/privacy/requesters/export"
payload := strings.NewReader("{\n \"email\": \"jsmith@example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.amdital.com/v1/privacy/requesters/export")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"jsmith@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.amdital.com/v1/privacy/requesters/export")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"jsmith@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"format": "amdital.helpdesk-requester-export.v1",
"exportedAt": "2023-11-07T05:31:56Z",
"cluster": {
"customers": 123,
"addresses": 123
},
"customers": [
{}
],
"aliasOnlyCustomers": [
{
"id": "<string>"
}
],
"tickets": [
{}
],
"messages": [
{}
],
"ccOnlyTickets": [
{
"id": "<string>",
"ticket_number": 123,
"fields": [
"cc"
]
}
],
"ccOnlyMessages": [
{
"id": "<string>",
"ticket_id": "<string>",
"fields": [
"cc"
]
}
],
"attachments": [
{
"id": "<string>",
"message_id": "<string>",
"file_name": "<string>",
"mime_type": "<string>",
"file_size": 123,
"created_at": "<string>"
}
],
"inboundEmails": [
{}
],
"truncated": [
"<string>"
]
}Privacy
Export a help-desk requester's personal data (GDPR Art. 15)
Keyed by the requester email in the POST body so the address never lands in a URL or access log. Requires the helpdesk.settings.manage.workspace permission; impersonation tokens get 403. Scoped to the JWT workspace. Rate-limited per user (429); writes a privacy.requester_export audit row.
POST
/
v1
/
privacy
/
requesters
/
export
Export a help-desk requester's personal data (GDPR Art. 15)
curl --request POST \
--url https://api.amdital.com/v1/privacy/requesters/export \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "jsmith@example.com"
}
'import requests
url = "https://api.amdital.com/v1/privacy/requesters/export"
payload = { "email": "jsmith@example.com" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: 'jsmith@example.com'})
};
fetch('https://api.amdital.com/v1/privacy/requesters/export', 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.amdital.com/v1/privacy/requesters/export",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'email' => 'jsmith@example.com'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.amdital.com/v1/privacy/requesters/export"
payload := strings.NewReader("{\n \"email\": \"jsmith@example.com\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.amdital.com/v1/privacy/requesters/export")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"email\": \"jsmith@example.com\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.amdital.com/v1/privacy/requesters/export")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"email\": \"jsmith@example.com\"\n}"
response = http.request(request)
puts response.read_body{
"format": "amdital.helpdesk-requester-export.v1",
"exportedAt": "2023-11-07T05:31:56Z",
"cluster": {
"customers": 123,
"addresses": 123
},
"customers": [
{}
],
"aliasOnlyCustomers": [
{
"id": "<string>"
}
],
"tickets": [
{}
],
"messages": [
{}
],
"ccOnlyTickets": [
{
"id": "<string>",
"ticket_number": 123,
"fields": [
"cc"
]
}
],
"ccOnlyMessages": [
{
"id": "<string>",
"ticket_id": "<string>",
"fields": [
"cc"
]
}
],
"attachments": [
{
"id": "<string>",
"message_id": "<string>",
"file_name": "<string>",
"mime_type": "<string>",
"file_size": 123,
"created_at": "<string>"
}
],
"inboundEmails": [
{}
],
"truncated": [
"<string>"
]
}Authorizations
Response
200 - application/json
Success
Everything the help desk holds about one external requester, matched by email. Address arrays hold only the subject's own addresses. attachments is metadata only (never the storage key, URL or content). inboundEmails lists the inbound mail log rows the requester sent (the log stores no mail body). truncated lists any collection that hit the row cap.
Was this page helpful?