Skip to main content
All CollectionsSecurity, Privacy & Terms
Programmatically delete users
Programmatically delete users
Updated this week

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.


💡 Deletion runs on a 24-hour schedule

After submitting a deletion request and receiving a 200 status response, the deletion is queued for the next scheduled run. It’s important to wait up to 24 hours for the process to complete and to ensure no further data is sent for the users marked for deletion. Sending new data may interfere with the process and reintroduce their information.

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?