REST API Developer Guide

Introducing Lightning Platform REST API
Quick Start
Examples
Getting Information About My Organization
Working with Object Metadata
Working with Records
Working with Searches and Queries
Insert or Update Blob Data
Working with Recently Viewed Information
Managing User Passwords
Working with Approval Processes and Process Rules
Using Event Monitoring
Describe Event Monitoring Using REST
Query Event Monitoring Data with REST
Get Event Monitoring Content from a Record
Download Large Event Log Files Using cURL with REST
Delete Event Monitoring Data
Generate Hourly Event Log Files (Beta)
Using Composite Resources
Reference
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Delete Event Monitoring Data

You can delete event log files that contain a user’s log data. Deleting log files helps you comply with data protection and privacy regulations and controls the information that others can access.
To delete an event log file, enable deletion in Setup, and assign a user permission in a permission set to your profile. Then you can query and delete the EventLogFile record by using Query and Delete resources in REST or delete() in SOAP.

You can’t delete individual rows from event logs. Because event logs are stored in blob format in the database, you must delete the entire log file that contains the user activity.

Note

  1. In Setup, in the Quick Find box, enter Event, and then select Event Monitoring Setup.
  2. Enable deletion of event monitoring data. This action is recorded in Setup Audit Trail.
    Event Monitoring Setup page showing Delete Event Monitoring data option enabled
    The Delete Event Monitoring Records user permission is now available to assign to a profile.
  3. In Setup, in the Quick Find box, enter Permission, and then select Permission Sets.
  4. Create a permission set that includes the Delete Event Monitoring Records user permission, and save the permission set.
  5. In Setup, in the Quick Find box, enter Profiles, and then select Profiles.
  6. Edit the profile of the user that you want to allow to delete event monitoring data.
  7. On the profile, assign the permission set you created and save the profile. This action is recorded in Setup Audit Trail.
    Any user assigned the profile can now delete event monitoring data. The next steps show you how to use the API to delete the data.
  8. Query the EventLogFile object to locate the logs containing the user activity that you want to delete. For details, see Query Event Monitoring Data with REST.
  9. Note the IDs of the returned logs.
  10. Use the SObject Rows resource to delete records. Specify the record ID and use the DELETE method. For more information, see Delete a Record. Or, you can use Workbench to delete blob format data for event monitoring. In the Execute text box, use a DELETE request similar to /services/data/v41.0/sobjects/EventLogFile/0ATD000000000pyOAA.