The DLP On Demand API allows synchronous and asynchronous content inspection.
Asynchronous content inspection lets users submit jobs to analyze content up to 128MB or perform column classification for DSPM purposes. This approach handles larger file sizes and provides enhanced details, including forensic information. Results are obtained by continuously polling the retrieve endpoint.
Synchronous content inspection is designed for users who want to analyze smaller files (less than 1MiB) and receive results within the same API call. This method provides less detailed results and excludes forensic information.
The DLP On Demand API is referenced below:
Endpoint and Authentication by Deployment Model
The API request and response specification is identical for both deployment models. What differs is the endpoint and how you authenticate.
| DLP On Demand Appliance | DLP On Demand Public Cloud | |
|---|---|---|
| API endpoint (FQDN) | Whatever hostname or IP you configured for your appliance (for example, https://10.0.0.1) | https://<shortname>.aws-<aws-region-code>.dlp.goskope.com — fixed to your tenant’s assigned AWS region. See Public Cloud Region Mapping. |
| Authentication | None. Appliance API calls don’t require authentication. | Required. API key generated in the WebUI, sent as Authorization: Bearer <API_KEY> on every call. See Public Cloud Region Mapping. |
- Get Pending Jobs
- Get Profiles
- Get Results of Prior DLP Inspection
- Perform DLP Content Inspection and Retrieve Results (Synchronous)
- Retrieve Results from a Submitted Asynchronous DLP Content Inspection job
- Start a DLP Content Inspection Job for Unstructured Data (Asynchronous)
- Start a Structured Classification Job (Asynchronous)