# Webhook aktualisieren (PUT)

Aktualisiere den Namen, die Nachrichtenvorlage, die Standardpriorität, die Aktionsbuttons oder den Aktivitätsstatus eines Webhooks. Nicht angegebene Felder behalten ihren aktuellen Wert.

## Endpunkt

```
PUT https://api.pocketalert.app/v1/webhooks/{tid}
```

## Authentifizierung

> **Info: Erforderlich**
>
> Füge einen dieser Header in deiner Anfrage hinzu:
> - `Token: <your-api-key>` — Hol ihn dir unter [API-Schlüssel](https://pocketalert.app/account/apikeys)
> - `Authorization: Bearer <jwt-token>` — Aus [Anmeldung](https://info.pocketalert.app/api/user/login.md)

## Anfrage

### Pfadparameter

| Parameter | Typ | Erforderlich | Beschreibung |
|-----------|-----|:------------:|--------------|
| `tid` | string | ✅ | Eindeutige ID des Webhooks |

### Header

| Header | Erforderlich | Beschreibung |
|--------|:------------:|--------------|
| `Token` | ✅ | Dein API-Schlüssel |
| `Authorization` | ✅ | `Bearer <jwt-token>` |

### Body-Parameter

| Parameter | Typ | Erforderlich | Beschreibung |
|-----------|-----|:------------:|--------------|
| `name` | string | ❌ | Neuer Name |
| `url` | string | ❌ | Neuer Slug der Empfangs-URL `https://p4a.me/wh/{url}`. Die alte URL funktioniert nicht mehr. Ein bereits vergebener Slug liefert `409` |
| `message` | string | ❌ | Neue Nachrichtenvorlage |
| `is_active` | boolean | ❌ | Webhook aktivieren/deaktivieren |
| `application_id` | string | ❌ | Neue TID der Anwendung |
| `device_id` | string | ❌ | Neue TID des Geräts |
| `default_level` | string \| int \| null | ❌ | Standardpriorität für Nachrichten dieses Webhooks, wenn die Payload kein `level` enthält: ein Name (`silent`…`critical`) oder ein Int (`-2`..`2`). `null` entfernt sie, sodass die Priorität der Anwendung gilt |
| `actions` | string | ❌ | JSON-Vorlage für Aktionsbuttons mit `%field.path%`-Platzhaltern, siehe [Webhook erstellen](https://info.pocketalert.app/api/webhooks/create.md#action-buttons-template). `""` entfernt die Buttons |

> **Warning: Webhook deaktivieren**
>
> Ein Webhook mit `is_active: false` nimmt weiterhin eingehende Anfragen entgegen und antwortet mit `200`, es wird aber kein Alert erstellt. Diese Aufrufe werden im [Webhook-Verlauf](https://info.pocketalert.app/api/webhooks/history.md) mit `error_code: inactive` protokolliert.

### Beispielanfrage

**cURL**

```bash
curl -X PUT "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx" \
  -H "Token: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GitHub Push (Inactive)",
    "is_active": false
  }'
```

**JavaScript**

```javascript
const tid = 'kblf7mh9j8jjyeh4fx';
const response = await fetch(`https://api.pocketalert.app/v1/webhooks/${tid}`, {
  method: 'PUT',
  headers: {
    'Token': 'your-api-key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'GitHub Push (Inactive)',
    is_active: false
  })
});
```

**Python**

```python
import requests

tid = 'kblf7mh9j8jjyeh4fx'
response = requests.put(
    f'https://api.pocketalert.app/v1/webhooks/{tid}',
    headers={'Token': 'your-api-key'},
    json={'name': 'GitHub Push (Inactive)', 'is_active': False}
)
print(response.json())
```

**PHP**

```php
$tid = 'kblf7mh9j8jjyeh4fx';
$response = Http::withHeaders([
    'Token' => 'your-api-key',
])->put('https://api.pocketalert.app/v1/webhooks/'.$tid, [
    'name' => 'GitHub Push (Inactive)',
    'is_active' => false,
]);

return $response->json();
```

## Antwort

### Erfolgreiche Antwort

> **Tip: 200 OK**
>
> Webhook erfolgreich aktualisiert

```json
{
  "data": "success"
}
```

### Fehlerantworten

| Status | Beschreibung |
|:------:|--------------|
| `400` | Bad Request — ungültige `default_level`- oder `actions`-Vorlage oder leerer `name` oder `message` |
| `401` | Unauthorized — Token ungültig oder fehlt |
| `404` | Not Found — Webhook, Anwendung oder Gerät existiert nicht |
| `409` | Conflict — der `url`-Slug ist bereits vergeben |
