Content migration in progress, completing by midnight IST on 17 November 2026.

Adding actions to the API policy

The configured action takes place when an API scan matches the conditions. Actions include Allow, Quarantine, Create Copy, Remove Share, and Encrypt (for Microsoft 365 only).

Allow

Selecting this action makes no change to the file in any way.

Quarantine

Allows you to replace a file violating the policy with a custom file. The file violating the policy can be moved to any application you have added and configured for API in Forcepoint ONE SSE under a defined legal hold or quarantine account. This will allow for a central repository for admins to review/investigate quarantined files across all applications in one location. You will need to setup a notification file that will replace the quarantined file, setup an admin (quarantine) account and a folder location in your application.

Notification File

Notification files can be uploaded on the page Protect > Objects > Common Objects in the Custom Notification Files card.

  • You can use default notification file or create your own file. Clicking on the green plus icon brings up the dialog to upload a custom file. Only PDF files can be uploaded as custom notification files.




    Note: The notification file that replaces the original file is renamed as <original_filename>_quarantined.pdf. The original file that is placed in the quarantine account is renamed to <username>_<original_filename>.

Quarantine Action Setup



When you select the action Quarantine, you will see a table appear with fields to configure for where the file will be sent to.

  1. App: This dropdown will you let you choose any other sanctioned application you have already setup in Forcepoint ONE SSE with API integration to send the file to.
  2. Instance: If you have multiple instances in the app, please select the one you wish to send the file to.
  3. Admin Account: Select the admin account (quarantine account) that will receive the quarantined file. The quarantine account should be an admin account in Forcepoint ONE SSE.
  4. Directory Path: The location of the folder within the application. Formatting will differ based on the application you are using:
    • SharePoint - https://<customer-domain>.sharepoint.com/<site-collection-name-with-directory-path>

      Example for tenant acme.com: https://acme.sharepoint.com/sites/examplesite/Shared Documents/Quarantine

    • OneDrive - /Files/<directory_path>
    • Google Drive - /My Drive/<directory_path>
    • Box - /All Files/<directory_path>
    • Dropbox - /<directory_path>
    • ServiceNow - /<table_name>
    • S3 - Bucket: <bucket_name> Folder Path: Optional
    • GCP - Bucket: <bucket_name> Folder Path: Optional
Note:
  • The Preview button lets you see a preview of 20 files matching the condition. This is not an exhaustive list of all the files matching the condition.
  • As a best practice, you should create a separate quarantine group, add the quarantine user to it and exclude it from Selective Scanning. This will ensure that your quarantined files are not scanned.

Create Copy

Works similarly to Quarantine except instead of moving the original file to a designated (quarantined) location, you create a copy of the file to move to a designated location for later inspection. This allows the original file to remain undisturbed, however the admin can review the copy of the file to ensure that it meets compliance and then take a manual action on the original file if needed. Setup is similar in that you can select a specific app, app instance, admin account, and folder path that the file will be placed in.



Encrypt

For Microsoft 365, you can select Encrypt to encrypt all data-at-rest matching your chosen condition inside of OneDrive and Sharepoint.

Classify

Forcepoint ONE SSE can apply a custom metadata classification tag to files via API. Classification tags are applied based on the configured API policy you have created. For files that are scanned, when they match the configured policy they will be applied the custom tag that you configure (with custom name and matching value.

Remove Sharing

Forcepoint ONE SSE offers the ability to remove various states of sharing from a file.