Create a DLP policy

POST

/dlp-policies/new

Create a DLP policy. It is validated exactly like a new policy saved in the
portal's policy builder, and is created disabled unless enabled is true.
Reference detectors by the keys POST /dlp-policies/detectors returns.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The created policy

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/dlp-policies/new' \
--header 'Content-Type: application/json' \
--data '{
    "enabled": true,
    "enforcement": [
        {
            "actor": {
                "company_in": [
                    "string"
                ],
                "department_in": [
                    "string"
                ],
                "job_title_in": [
                    "string"
                ],
                "organization_lead_in": [
                    "string"
                ],
                "status_in": [
                    "automation"
                ],
                "user_in": [
                    "string"
                ],
                "watchlist_label_in": [
                    "string"
                ]
            },
            "channel": [
                "unspecified"
            ],
            "destination": {
                "account": "any",
                "category_in": [
                    "AI Tools",
                    "Personal Cloud Storage"
                ],
                "device_serial_in": [
                    "string"
                ],
                "device_vendor_id_in": [
                    "0781"
                ],
                "host_in": [
                    "openai.com"
                ],
                "host_matches": [
                    "string"
                ],
                "printer_in": [
                    "string"
                ]
            },
            "destination_category": [
                "string"
            ],
            "require_justification": true,
            "verdict": "block"
        }
    ],
    "name": "Customer PII protection",
    "rules": [
        {
            "condition": {
                "actor": {
                    "company_in": [
                        "string"
                    ],
                    "department_in": [
                        "string"
                    ],
                    "job_title_in": [
                        "string"
                    ],
                    "organization_lead_in": [
                        "string"
                    ],
                    "status_in": [
                        "automation"
                    ],
                    "user_in": [
                        "string"
                    ],
                    "watchlist_label_in": [
                        "string"
                    ]
                },
                "category": {
                    "detector_key": "financials_nonpublic",
                    "score_gte": 0
                },
                "composite": {
                    "conditions": [
                        {
                            "property1": "string",
                            "property2": "string"
                        }
                    ],
                    "operator": "and"
                },
                "destination": {
                    "account": "any",
                    "category_in": [
                        "AI Tools",
                        "Personal Cloud Storage"
                    ],
                    "device_serial_in": [
                        "string"
                    ],
                    "device_vendor_id_in": [
                        "0781"
                    ],
                    "host_in": [
                        "openai.com"
                    ],
                    "host_matches": [
                        "string"
                    ],
                    "printer_in": [
                        "string"
                    ]
                },
                "document": {
                    "file_type_in": [
                        "xlsx",
                        "csv"
                    ],
                    "text_length_gte": 0
                },
                "entity": {
                    "confidence_gte": 0,
                    "count_gte": 0,
                    "count_lte": 0,
                    "detector_key": "PII_SSN",
                    "occurrence": {
                        "basis_in": [
                            "checksum_only"
                        ],
                        "card": {
                            "known_network_only": true,
                            "separators_in": [
                                "bare"
                            ]
                        }
                    }
                },
                "origin": {
                    "corporate_source": true
                }
            },
            "name": "bulk customer PII export",
            "weight": 0.8
        }
    ],
    "threshold": 0.6
}'

Response Example

{
    "policy": {
        "created": "2019-08-24T14:15:22.123Z",
        "enforcement": [
            {
                "actor": {
                    "company_in": [
                        "string"
                    ],
                    "department_in": [
                        "string"
                    ],
                    "job_title_in": [
                        "string"
                    ],
                    "organization_lead_in": [
                        "string"
                    ],
                    "status_in": [
                        "automation"
                    ],
                    "user_in": [
                        "string"
                    ],
                    "watchlist_label_in": [
                        "string"
                    ]
                },
                "channel": [
                    "unspecified"
                ],
                "destination": {
                    "account": "any",
                    "category_in": [
                        "AI Tools",
                        "Personal Cloud Storage"
                    ],
                    "device_serial_in": [
                        "string"
                    ],
                    "device_vendor_id_in": [
                        "0781"
                    ],
                    "host_in": [
                        "openai.com"
                    ],
                    "host_matches": [
                        "string"
                    ],
                    "printer_in": [
                        "string"
                    ]
                },
                "destination_category": [
                    "string"
                ],
                "require_justification": true,
                "verdict": "block"
            }
        ],
        "id": "8CA67511-744C-4D74-B26E-7281CF88712F",
        "name": "Customer PII protection",
        "rules": [
            {
                "condition": {
                    "actor": {
                        "company_in": [
                            "string"
                        ],
                        "department_in": [
                            "string"
                        ],
                        "job_title_in": [
                            "string"
                        ],
                        "organization_lead_in": [
                            "string"
                        ],
                        "status_in": [
                            "automation"
                        ],
                        "user_in": [
                            "string"
                        ],
                        "watchlist_label_in": [
                            "string"
                        ]
                    },
                    "category": {
                        "detector_key": "financials_nonpublic",
                        "score_gte": 0
                    },
                    "composite": {
                        "conditions": [
                            {
                                "property1": "string",
                                "property2": "string"
                            }
                        ],
                        "operator": "and"
                    },
                    "destination": {
                        "account": "any",
                        "category_in": [
                            "AI Tools",
                            "Personal Cloud Storage"
                        ],
                        "device_serial_in": [
                            "string"
                        ],
                        "device_vendor_id_in": [
                            "0781"
                        ],
                        "host_in": [
                            "openai.com"
                        ],
                        "host_matches": [
                            "string"
                        ],
                        "printer_in": [
                            "string"
                        ]
                    },
                    "document": {
                        "file_type_in": [
                            "xlsx",
                            "csv"
                        ],
                        "text_length_gte": 0
                    },
                    "entity": {
                        "confidence_gte": 0,
                        "count_gte": 0,
                        "count_lte": 0,
                        "detector_key": "PII_SSN",
                        "occurrence": {
                            "basis_in": [
                                "checksum_only"
                            ],
                            "card": {
                                "known_network_only": true,
                                "separators_in": [
                                    "bare"
                                ]
                            }
                        }
                    },
                    "origin": {
                        "corporate_source": true
                    }
                },
                "name": "bulk customer PII export",
                "weight": 0.8
            }
        ],
        "threshold": 0.6,
        "updated": "2019-08-24T14:15:22.123Z",
        "version": "1"
    },
    "warnings": [
        "string"
    ]
}

Modified at 2026-11-02 15:06:45

Update a DLP policy

List devices