# Delete an alert subscription

`DELETE /v3/alerts/{id}`

Removes the subscription; delivery history retention is unaffected.

## Authentication

Required. Send an API key in the `x-api-key` header.

## Parameters

```json
[
  {
    "name": "id",
    "in": "path",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]
```

## Request body

None.

## Responses

```json
{
  "204": {
    "description": "Deleted."
  },
  "401": {
    "$ref": "#/components/responses/Unauthorized"
  },
  "404": {
    "$ref": "#/components/responses/SubjectMiss"
  },
  "429": {
    "$ref": "#/components/responses/RateLimited"
  },
  "500": {
    "$ref": "#/components/responses/Internal"
  }
}
```

Schema references resolve against the [canonical OpenAPI specification](https://api.aixbt.tech/v3/openapi.yaml).