Skip to main content
Version: Next

Deleting Events

Events can be deleted by event_type, which removes them from Workstation. However, if the source data remains in Kafka, re-ingesting it will cause those events to reappear.

To permanently delete the data, it must also be removed from the Kafka source topic. This can be achieved by deleting the topic or redeploying an Authoring pattern with the Reset Topic flag set to true.

Required Permissions
Access to this capability requires the following permissions:
 View & Edit
Workstation
→
Ingest
 View & Edit
Workstation
→
Data Delete

Deleting Single Sets of Events​

Sets of events can be deleted one at a time.

To delete a single set of events:

  1. At the top right of Cogynt Workstation's home page, click the Settings cog.
  2. From the left side drawer, click Data Ingestion.
  3. Find the event you wish to ingest. (Utilize the Search Bar and Filter By menu to narrow down the list of events.)
  4. Click the More menu (⋮) for the event.
  5. Click Delete Data.

Deleting Multiple Sets of Events​

If multiple sets of data require deletion, they can be removed in a single action.

To delete multiple sets of events:

  1. At the top right of Cogynt Workstation's home page, click the Settings cog.
  2. From the left side drawer, click Data Ingestion.
  3. Click the DELETE button. Two menu tabs appear:
    1. Global Mode: Contains 3 global deletion options:
      1. DELETE DATA: Deletes data from Workstation. Collections, tags, notes for collections, and attachments for notes are retained.
      2. DELETE DATA AND DEPLOYMENT TOPIC: Does the same as Delete Data, but also deletes the deployment topic in Kafka. Selecting this option requires a new deployment to be run from Authoring for events to appear on the Data Ingestion table again.
      3. DELETE DRILLDOWN DATA: Resets and re-ingests the data used to generate the drilldown view for events.
    2. Event Mode: Allows deleting multiple event types:
      1. Select one or multiple events.
      2. Click DELETE EVENTS.

Automatic Deletion​

With some preparatory work in Cogynt Authoring, Workstation can be configured to automatically delete events that meet custom criteria:

  1. When Authoring produces an event for the first time, it includes a $crud: create field in the data, which instructs Workstation to create the event. Updates to that event are sent with $crud: update, which Workstation reads to apply any new values.
  2. If Authoring includes custom deletion logic and the criteria are met, the event is marked with $crud: delete. Workstation interprets this signal and deletes that specific event from Workstation.
  3. When ingestion is running for a given set of events, individual events are deleted if an associated pattern in Authoring meets the chosen deletion criteria.