# Custom detections

Manage the custom detections configured across your organization.

 - [GET /v1/controls/customDetections](https://push-security-prd-ba8f0f76-a2d2-42f5-aea2-d421.redocly.app/help/audience/engineering/rest-v1/custom-detections/get-controls-customdetections.md): Returns your organization's custom detections. Each entry includes the detection event type and name only; retrieve a detection individually for its logic and rules.
 - [POST /v1/controls/customDetections](https://push-security-prd-ba8f0f76-a2d2-42f5-aea2-d421.redocly.app/help/audience/engineering/rest-v1/custom-detections/post-controls-customdetections.md): Creates a custom detection from the name, detection logic and rules you send. The detection event type is derived from the name, returned in the response, and cannot be changed afterwards. Rules are e
 - [GET /v1/controls/customDetections/{detectionEventType}](https://push-security-prd-ba8f0f76-a2d2-42f5-aea2-d421.redocly.app/help/audience/engineering/rest-v1/custom-detections/get-controls-customdetections-detectioneventtype.md): Returns one custom detection in full: its detection logic exactly as stored, and every rule and its settings. Rules are returned in the order they're evaluated, with the highest-priority rule first.
 - [PUT /v1/controls/customDetections/{detectionEventType}](https://push-security-prd-ba8f0f76-a2d2-42f5-aea2-d421.redocly.app/help/audience/engineering/rest-v1/custom-detections/put-controls-customdetections-detectioneventtype.md): Replaces the custom detection's logic and rules with what you send. Any rule you don't include is deleted. The detection event name cannot be changed, and is ignored if you send one. A rule with an `i
 - [DELETE /v1/controls/customDetections/{detectionEventType}](https://push-security-prd-ba8f0f76-a2d2-42f5-aea2-d421.redocly.app/help/audience/engineering/rest-v1/custom-detections/delete-controls-customdetections-detectioneventtype.md): Permanently deletes a custom detection and all of its rules. It cannot be undone. Deleting a detection that does not exist succeeds without making any changes.