> ## Documentation Index
> Fetch the complete documentation index at: https://docs.charlemagnelabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Alert Endpoints

> API endpoints for managing security alert webhooks

Alert endpoints are HTTP destinations that Charley POSTs to when a security event occurs. See [Webhooks](/integrations/webhooks) for the full integration guide.

## List Alert Endpoints

```
GET /api/org-alert-endpoints
```

### Response

```json theme={null}
[
  {
    "id": "ep_01hx...",
    "url": "https://hooks.example.com/charley",
    "description": "PagerDuty integration",
    "created_at": "2025-10-01T00:00:00Z"
  }
]
```

***

## Create an Alert Endpoint

```
POST /api/org-alert-endpoints
```

### Request Body

```json theme={null}
{
  "url": "https://hooks.example.com/charley",
  "description": "PagerDuty integration"
}
```

| Field         | Type   | Required | Description                 |
| ------------- | ------ | -------- | --------------------------- |
| `url`         | string | Yes      | HTTPS URL to send alerts to |
| `description` | string | No       | Human-readable label        |

### Response

`201 Created`

```json theme={null}
{
  "id": "ep_01hx...",
  "url": "https://hooks.example.com/charley",
  "description": "PagerDuty integration",
  "created_at": "2025-10-14T18:00:00Z"
}
```

***

## Delete an Alert Endpoint

```
DELETE /api/org-alert-endpoints/:id
```

### Response

`204 No Content`

### Errors

| Code  | Description                                      |
| ----- | ------------------------------------------------ |
| `403` | Caller does not have `ORG_ADMIN` role            |
| `404` | Endpoint not found or belongs to a different org |