---
search:
  tags:
    - alerts
    - PUT
seo:
  description: >-
    Omitted keeps the stored value, an empty string clears it. Stored… Reference
    for the PUT /api/v1/alert-delivery endpoint in the TimescaleDB Enterprise
    API.
  noindex: true
sidebar:
  label: Set heartbeat destination
  badge: PUT
title: Set heartbeat destination
type: openapi-operation
---
Omitted keeps the stored value, an empty string clears it. Stored encrypted. Responds with the same redacted shape as the GET, so the console can update without a second request.

`PUT /api/v1/alert-delivery`

**Request body** (`application/json`, required)

- `watchdogWebhookUrl` (string) — Absolute http/https URL. Omit to keep; empty string clears

Request body example:

```json
{
  "watchdogWebhookUrl": "string"
}
```

**Responses**

- `200` — OK
- `default` — Error

Response example, 200:

```json
{
  "destinations": [
    {
      "display": "string",
      "global": true,
      "id": 0,
      "kind": "webhook",
      "minSeverity": "warning",
      "name": "string",
      "usedBy": [
        {
          "serviceId": "string",
          "serviceName": "string"
        }
      ]
    }
  ],
  "watchdog": {
    "configured": true,
    "display": "string"
  }
}
```
