Skip to content

Erase everything stored about a user

POST
/v1/privacy/erase
curl --request POST \
--url https://stats.example.com/v1/privacy/erase \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "userHashes": [], "userId": "example" }'

From an SDK: user hashes (the raw ID only in audit mode). From the dashboard: an exact Discord user ID. Every erasure is logged.

Media typeapplication/json
object
userHashes
Array<string>
default: <= 8 items
userId
string
/^(?:\d{17,18}|[1-8]\d{18}|9[01]\d{17})$/

Rows removed

Nothing to erase, or a raw ID in privacy mode

Media typeapplication/json
object
error
required
string
<= 64 characters
message
string
<= 500 characters
rejected
Array<object>
object
index
required
integer
<= 9007199254740991
reason
required
string
<= 64 characters

Example generated

{
"error": "example",
"message": "example",
"rejected": [
{
"index": 1,
"reason": "example"
}
]
}

Not signed in

Media typeapplication/json
object
error
required
string
<= 64 characters
message
string
<= 500 characters
rejected
Array<object>
object
index
required
integer
<= 9007199254740991
reason
required
string
<= 64 characters

Example generated

{
"error": "example",
"message": "example",
"rejected": [
{
"index": 1,
"reason": "example"
}
]
}

Needs a Discord sign-in (owner or team) and, for changes, the CSRF header

Media typeapplication/json
object
error
required
string
<= 64 characters
message
string
<= 500 characters
rejected
Array<object>
object
index
required
integer
<= 9007199254740991
reason
required
string
<= 64 characters

Example generated

{
"error": "example",
"message": "example",
"rejected": [
{
"index": 1,
"reason": "example"
}
]
}