---
title: "Delete Org Alert Policy"
method: DELETE
path: "/orgs/{org_slug}/alert-policies/{policy_id}"
tags: ["alert-policies"]
---

# Delete Org Alert Policy

`DELETE /orgs/{org_slug}/alert-policies/{policy_id}`

## Request

- Base URL: `https://api.socket.dev/v0`
- URL: `https://api.socket.dev/v0/orgs/{org_slug}/alert-policies/{policy_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic

Delete an alert policy along with its rules and repo label. Repositories previously scoped to the policy fall back to the default policy after the next org snapshot. The default policy cannot be deleted. Requires a token with org-wide repository access; repo-restricted tokens receive 403.

This endpoint consumes 1 unit of your quota.

This endpoint requires the following org token scopes:
- alert-policy:delete

## Path parameters

- `org_slug` string, required
- `policy_id` string, required

## Query parameters

- `dry_run` boolean

## Response `200`

Deleted the alert policy, or rehearsed the delete when `dry_run` is true.

- object
  - `result` string: Present on a persisted delete.
  - `dry_run` boolean: True when `?dry_run=true` (or `1` / `yes`) rehearsed the write; nothing was persisted.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Insufficient max_quota for API method
- `404`: Resource not found
- `409`: Resource already exists
- `429`: Insufficient quota for API route

## Changes

- **2026-11-03** `5ad8bf36b1e7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/socket-dev/apis/socket/changes/orgs/:org_slug/alert-policies/:policy_id/delete.md)

---

[API](https://skmtc.dev/socket-dev/apis/socket.md) - [All operations](https://skmtc.dev/socket-dev/apis/socket/llms.txt) - [OpenAPI document](https://skmtc.dev/socket-dev/apis/socket/revisions/5ad8bf36b1e7?raw)