Skip to main content
All CollectionsSecurity, Privacy & Terms
Programmatically delete users
Programmatically delete users
Updated over 3 months ago

In keeping with June’s commitment to GDPR and CCPA readiness, June offers the ability to delete and suppress data about end-users when they are identifiable by a userId, should they request it from you.


In order to request a data deletion of a user_id you need to send a POST request to our deletion endpoint.

User deletion - POST /api/platform/data_management/user_deletion_request

Each request needs to be authenticated using a secret API key. To generate a key for your workspace click here.

To authenticate your requests add your API_KEY to the headers of your requests like
Authorisation: Basic #{YOUR_API_KEY}

Parameters

Type

Example value

Required

user_id

string

"abcd-256"

Yes

Here's an example curl request to this endpoint:

curl -X POST "https://api.june.so/api/platform/data_management/user_deletion_request" \
-H "Authorization: Basic YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id":"abcd-256"}'

User deletion - GET /api/platform/data_management/user_deletion_requests

Each request needs to be authenticated using a secret API key. To generate a key for your workspace click here.

To authenticate your requests add your API_KEY to the headers of your requests like
Authorisation: Basic #{YOUR_API_KEY}

Parameters

Type

Example value

Required

state

enum with values:
"requested", "started", "finished"

"requested"

No

page

Integer, starting from 1

1

No

Here's an example curl request to this endpoint:

curl -X GET "https://api.june.so/api/platform/data_management/user_deletion_requests" \
-H "Authorization: Basic YOUR_API_KEY" \
-H "Content-Type: application/json"

# with the state parameter

curl -X GET "https://api.june.so/api/platform/data_management/user_deletion_requests?state=requested" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json"


# with the page parameter

curl -X GET "https://api.june.so/api/platform/data_management/user_deletion_requests?page=1" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json"

Group deletion - POST /api/platform/data_management/group_deletion_request

Each request needs to be authenticated using a secret API key. To generate a key for your workspace click here.

To authenticate your requests add your API_KEY to the headers of your requests like
Authorisation: Basic #{YOUR_API_KEY}

Parameters

Type

Example value

Required

group_id

string

"abcd-256"

Yes

Here's an example curl request to this endpoint:

curl -X POST "https://api.june.so/api/platform/data_management/group_deletion_request" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"group_id":"abcd-256"}'

Group deletion - GET /api/platform/data_management/group_deletion_requests

Each request needs to be authenticated using a secret API key. To generate a key for your workspace click here.

To authenticate your requests add your API_KEY to the headers of your requests like
Authorisation: Basic #{YOUR_API_KEY}

Parameters

Type

Example value

Required

state

enum with values:
"requested", "started", "finished"

"requested"

No

page

Integer, starting from 1

1

No

Here's an example curl request to this endpoint:

# If you don't need any filters

curl -X GET "https://api.june.so/api/platform/data_management/group_deletion_requests" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json"

# with the state parameter

curl -X GET "https://api.june.so/api/platform/data_management/group_deletion_requests?state=requested" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json"


# with the page parameter

curl -X GET "https://api.june.so/api/platform/data_management/group_deletion_requests?page=1" \
-H "Authorization: Basic YOUR_SECRET_API_KEY" \
-H "Content-Type: application/json"

All deletions are processed asynchronously within 72 hours from your request and data is deleted permanently from our systems in 90 days.

Did this answer your question?