curl --request POST \
--url https://app.usertick.com/api/public/v1/responses/erase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "[email protected]"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: '[email protected]'})
};
fetch('https://app.usertick.com/api/public/v1/responses/erase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/responses/erase"
payload = { "email": "[email protected]" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"type": "responses.erase",
"status": "queued",
"subject": "m***@example.com",
"result": {
"responsesErased": 0,
"filesDeleted": 0
},
"error": null,
"url": "https://app.usertick.com/api/public/v1/jobs/7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"createdAt": "2026-10-01T09:00:00.000Z",
"startedAt": null,
"finishedAt": null
}Erase a respondent
GDPR erasure of every response of one respondent, found by email or by the site’s user id. By email: every response with an answer that is exactly the address or whose identify email it is, every one an email survey link sent to the contact with it, every one linked to that contact, and every one sent with the contact’s external id as its user id. By userId: every response sent with it and every one linked to the contact whose external id it is. Erased the way DELETE /responses/ erases one. The email or user id is kept encrypted only while the job runs. 202 with the job.
Scopes: responses:delete.
curl --request POST \
--url https://app.usertick.com/api/public/v1/responses/erase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"email": "[email protected]"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({email: '[email protected]'})
};
fetch('https://app.usertick.com/api/public/v1/responses/erase', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://app.usertick.com/api/public/v1/responses/erase"
payload = { "email": "[email protected]" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"id": "7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"type": "responses.erase",
"status": "queued",
"subject": "m***@example.com",
"result": {
"responsesErased": 0,
"filesDeleted": 0
},
"error": null,
"url": "https://app.usertick.com/api/public/v1/jobs/7a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"createdAt": "2026-10-01T09:00:00.000Z",
"startedAt": null,
"finishedAt": null
}Authorizations
An API key (utk_live_...) or an app's OAuth access token (uto_...).
Headers
Any 1 to 255 printable ASCII characters, without a space at either end. The answer to the first request with a key is kept for 24 hours per credential: the same request again gets it back (Idempotent-Replayed: true), another request with the key is 409 PUB-002-002, and while the first still runs 409 PUB-002-003. A server error is not kept, and a request that never answered frees its key after 2 minutes: a retry with the key then runs again.
255Body
Response
The job.
responses.erase, responses.delete queued, running, succeeded, failed The response id, or the respondent's email masked.
Show child attributes
Show child attributes
An error code when it failed.
"2026-09-30T10:00:00.000Z"
"2026-09-30T10:00:00.000Z"
"2026-09-30T10:00:00.000Z"