From 63592249404c1e974c32ed8ba47fb47d8d786365 Mon Sep 17 00:00:00 2001 From: forstisabella <92472883+forstisabella@users.noreply.github.com> Date: Wed, 29 Oct 2025 15:36:02 -0400 Subject: [PATCH 1/4] UI parity, Regulations -> regulations --- src/privacy/user-deletion-and-suppression.md | 74 +++++++++++++------- 1 file changed, 49 insertions(+), 25 deletions(-) diff --git a/src/privacy/user-deletion-and-suppression.md b/src/privacy/user-deletion-and-suppression.md index fc1802199c..db36d4520d 100644 --- a/src/privacy/user-deletion-and-suppression.md +++ b/src/privacy/user-deletion-and-suppression.md @@ -9,33 +9,33 @@ Segment offers you the ability to delete and suppress data about your end-users ## Regulations -All deletion and suppression actions in Segment are asynchronous and categorized as Regulations, or requests to Segment to control your data flow. You can issue Regulations from: +All deletion and suppression actions in Segment are asynchronous and categorized as regulations, or requests to Segment to control your data flow. You can issue regulations from: - Your Segment Workspace (Settings > End User Privacy) - [Segment's Public API](https://docs.segmentapis.com/tag/Deletion-and-Suppression){:target="_blank"}. You can delete up to 5000 `userId`s per call using the Public API. -With Regulations, you can issue a single request to delete and suppress data about a user by `userId`. Segment scopes Regulations to all sources in your workspace. +With regulations, you can issue a single request to delete and suppress data about a user by `userId`. Segment scopes regulations to all sources in your workspace. > warning "Data sent to device-mode destinations cannot be suppressed" > Destinations set up in device mode are sent directly to destinations and bypass the point in the pipeline where Segment suppresses events. -Segment has 2 types of Regulations: -- **Segment-only Regulations**: These Regulations *only* delete or suppress data about your user from internal Segment systems. -- **Segment & Destination Regulations**: These Regulations delete user data from internal Segment systems and then forward a deletion request to any connected destinations that support programmatic deletion. For a list of destination that support programmatic deletion, see [Which destinations can I send deletion requests to?](/docs/privacy/faq/#which-destinations-can-i-send-deletion-requests-to). +Segment has 2 types of regulations: +- **Segment-only regulations**: These regulations *only* delete or suppress data about your user from internal Segment systems. +- **Segment & Destination regulations**: These regulations delete user data from internal Segment systems and then forward a deletion request to any connected destinations that support programmatic deletion. For a list of destination that support programmatic deletion, see [Which destinations can I send deletion requests to?](/docs/privacy/faq/#which-destinations-can-i-send-deletion-requests-to). -While both Regulation types are limited to 110,000 users every calendar month, you can temporarily increase your rate limit for Segment-only Regulations. To send more than 110,000 Segment-only Regulations over a 30 day period, [contact Segment Support](https://segment.com/help/contact/){:target="_blank"}. +While both regulation types are limited to 110,000 users every calendar month, you can temporarily increase your rate limit for Segment-only regulations. To send more than 110,000 Segment-only regulations over a 30 day period, [contact Segment Support](https://segment.com/help/contact/){:target="_blank"}. -### Segment-only Regulations -The following Segment-only Regulation types are available: +### Segment-only regulations +The following Segment-only regulation types are available: - **SUPPRESS_WITH_DELETE_INTERNAL*:** Suppress new data and delete from Segment internal systems only - **DELETE_INTERNAL*:** Delete data from Segment internal systems only - **SUPPRESS_ONLY***: Suppress new data without deleting existing data - **UNSUPPRESS*:** Stop an ongoing suppression -### Segment & Destination Regulations +### Segment & Destination regulations -The following Segment & Destination Regulations are available: +The following Segment & Destination regulations are available: - **SUPPRESS_WITH_DELETE:** Suppress new data and delete existing data - **DELETE_ONLY:** Delete existing data without suppressing any new data @@ -59,34 +59,58 @@ Warehouse deletions occur using a DML run against your cluster or instance. Segm ### Deletion requests tab -The deletion requests tab shows a 30-day overview of your deletions pipeline, including a Regulations usage tracker and a deletion requests status table. The deletion requests summary tab shows the status of all your deletion requests from the last 30 days and might not accurately reflect your current deletion request limits. +The deletion requests tab shows a 30-day overview of your deletions pipeline, including a regulations usage tracker and a deletion requests status table. The deletion requests summary tab shows the status of all your deletion requests from the last 30 days and might not accurately reflect your current deletion request limits. To navigate to the deletion requests tab, open the Segment app and navigate to **Privacy > Deletion and Suppression > Deletion**. +If you need to verify if information about a specific user was deleted or suppressed, you can search for a `userId` to view its status in Segment internal systems and in any connected destinations. + #### Regulations usage tracker -The usage tracker on the deletion requests tab shows you how many Segment & destination Regulations and how many Segment-only Regulations you have remaining for the calendar month. +The usage tracker on the deletion requests tab shows you how many Segment & destination regulations and how many Segment-only regulations you have remaining for the calendar month. #### Deletion requests status -The deletion requests status table allows you to see the status of each of the Regulations that you've submitted, including if the Regulation was forwarded to your destinations, the deletion type, the date the Regulation was received, and the date the Regulation was completed. +The deletion requests status table allows you to see the status of each of the regulations that you've submitted, including: +- User identifier +- Regulation type +- Status of actions taken in internal Segment stores +- If the regulation was forwarded to your destinations, the status of that request +- The date that Segment received your regulation +- The date that Segment completed a regulation + +To view more information about a regulation, select it from the deletion requests tab. On the side sheet for that regulation, you can view the status of your regulation within Segment and in downstream destinations, the ID of the source the regulation was coming from, and, if applicable, the reason a regulation failed. + +Segment actions can have the following statuses: + +- **Initialized**: Segment started processing your regulation +- **In progress**: Segment has started processing your regulation +- **Success**: Segment processed your regulation +- **Failed**: Segment was unable to process your regulation + +Destination regulations can have the following statuses: + +- **No action**: Segment didn't forward your regulation to a downstream destination +- **Initialized**: Segment forwarded your regulation to a downstream destination +- **In progress**: The destination started processing your regulation +- **Success**: The destination processed your regulation +- **Failed**: The destination was unable to process your regulation + -> info "" -> The deletion requests status table includes requests from the past 90 days. +#### Deletion requests made using Segment's API -If you need to verify if information about a specific user was deleted or suppressed, you can search for a `userId` to view its status in Segment internal systems and in the connected destinations. +When checking the status of deletion requests using Segment's API, the deletion will report an overall status of all of the deletion processes. As a result, Segment might return a `FAILED` status because of a failure on an unsupported destination, even if the deletion from the Segment Internal Systems and supported destinations was completed successfully. -A deletion request can have one of the following statuses: +Segment's API returns the following statuses: -1. `INITIALIZED` -2. `INVALID` -3. `NOT_SUPPORTED` -4. `RUNNING` -5. `PARTIAL_SUCCESS` -6. `FAILED` -7. `FINISHED` +- `INVALID` +- `NOT_SUPPORTED` +- `RUNNING` +- `PARTIAL_SUCCESS` +- `FAILED` +- `FINISHED` -When checking the status of deletion requests using Segment's API, the deletion will report an overall status of all of the deletion processes. As a result, Segment returns a `FAILED` status because of a failure on an unsupported destination, even if the deletion from the Segment Internal Systems and supported destinations were completed successfully. +For more granular deletion request statuses, see the [Deletion requests tab](#deletion-requests-tab) in the Segment app. ### Deletion request SLA From c1a9fc95ab85986492ac29f343886ff47e72fc89 Mon Sep 17 00:00:00 2001 From: forstisabella <92472883+forstisabella@users.noreply.github.com> Date: Thu, 30 Oct 2025 11:43:30 -0400 Subject: [PATCH 2/4] Apply suggestion from @forstisabella --- src/privacy/user-deletion-and-suppression.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/privacy/user-deletion-and-suppression.md b/src/privacy/user-deletion-and-suppression.md index db36d4520d..67f3a4f86b 100644 --- a/src/privacy/user-deletion-and-suppression.md +++ b/src/privacy/user-deletion-and-suppression.md @@ -90,7 +90,7 @@ Segment actions can have the following statuses: Destination regulations can have the following statuses: -- **No action**: Segment didn't forward your regulation to a downstream destination +- **No action**: Used for Segment-only regulations to indicate that they weren't forwarded to a downstream destination - **Initialized**: Segment forwarded your regulation to a downstream destination - **In progress**: The destination started processing your regulation - **Success**: The destination processed your regulation From e69c2be3c379d0158a673451ff827a6e38a33721 Mon Sep 17 00:00:00 2001 From: forstisabella <92472883+forstisabella@users.noreply.github.com> Date: Thu, 30 Oct 2025 11:43:40 -0400 Subject: [PATCH 3/4] Apply suggestion from @forstisabella --- src/privacy/user-deletion-and-suppression.md | 1 + 1 file changed, 1 insertion(+) diff --git a/src/privacy/user-deletion-and-suppression.md b/src/privacy/user-deletion-and-suppression.md index 67f3a4f86b..ff92e4d1f7 100644 --- a/src/privacy/user-deletion-and-suppression.md +++ b/src/privacy/user-deletion-and-suppression.md @@ -103,6 +103,7 @@ When checking the status of deletion requests using Segment's API, the deletion Segment's API returns the following statuses: +- `INITIALIZED` - `INVALID` - `NOT_SUPPORTED` - `RUNNING` From d6745d75fb3ebe5ad738995b87f00e8525016e59 Mon Sep 17 00:00:00 2001 From: forstisabella <92472883+forstisabella@users.noreply.github.com> Date: Thu, 30 Oct 2025 14:02:36 -0400 Subject: [PATCH 4/4] update language per eng [netlify-build] --- src/privacy/user-deletion-and-suppression.md | 26 ++++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/src/privacy/user-deletion-and-suppression.md b/src/privacy/user-deletion-and-suppression.md index ff92e4d1f7..f497ba64fa 100644 --- a/src/privacy/user-deletion-and-suppression.md +++ b/src/privacy/user-deletion-and-suppression.md @@ -79,22 +79,22 @@ The deletion requests status table allows you to see the status of each of the r - The date that Segment received your regulation - The date that Segment completed a regulation -To view more information about a regulation, select it from the deletion requests tab. On the side sheet for that regulation, you can view the status of your regulation within Segment and in downstream destinations, the ID of the source the regulation was coming from, and, if applicable, the reason a regulation failed. +To view more information about a deletion request, select the userID on the deletion requests tab. On the side sheet for that deletion request, you can view the status of the request within Segment and in downstream destinations, and, if applicable, the reason a request failed. -Segment actions can have the following statuses: +Segment deletion requests can have the following statuses: -- **Initialized**: Segment started processing your regulation -- **In progress**: Segment has started processing your regulation -- **Success**: Segment processed your regulation -- **Failed**: Segment was unable to process your regulation +- **Initialized**: Segment accepted your deletion request and placed it in the deletions queue +- **In progress**: Segment started processing your deletion request +- **Success**: Segment processed your deletion request +- **Failed**: Segment was unable to process your deletion request -Destination regulations can have the following statuses: +Destination deletion requests can have the following statuses: -- **No action**: Used for Segment-only regulations to indicate that they weren't forwarded to a downstream destination -- **Initialized**: Segment forwarded your regulation to a downstream destination -- **In progress**: The destination started processing your regulation -- **Success**: The destination processed your regulation -- **Failed**: The destination was unable to process your regulation +- **No action**: Used for Segment-only deletion requests to indicate that they weren't forwarded to a downstream destination +- **Initialized**: Segment added your deletion request to a queue to send to a destination +- **In progress**: Segment started forwarding your deletion request to a destination +- **Forwarded**: Segment forwarded your request to a destination +- **Failed**: Segment was unable to forward your request to a destination #### Deletion requests made using Segment's API @@ -111,7 +111,7 @@ Segment's API returns the following statuses: - `FAILED` - `FINISHED` -For more granular deletion request statuses, see the [Deletion requests tab](#deletion-requests-tab) in the Segment app. +For more granular deletion request statuses, see the [Deletion requests tab](#deletion-requests-status) in the Segment app. ### Deletion request SLA