---
title: "Kunden-IP aktualisieren"
description: "Aktualisiert eine Kunden-IP (z.B. Label oder Status)."
---

`PATCH /api/customer-ips/:customerIpPublicId`

Hinweise:

- Readonly-User und Global Supporter dürfen nicht mutieren.
- Aktivieren kann wegen Quota-Limits abgelehnt werden.

## Anfrage (Request Body)

```json
{
  "label": "Mail Server",
  "status": "active"
}
```

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X PATCH "$BASE_URL/api/customer-ips/11111111-1111-4111-8111-111111111111" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label":"Mail Server","status":"active"}'
```

## Häufige Fehler

- `400 Invalid IP identifier` wenn `:customerIpPublicId` weder UUID noch Legacy-ID ist
- `400` Body-Validierungsfehler (z.B. ungültiger `status`)
- `401 Unauthorized` wenn du nicht angemeldet bist
- `403 Forbidden` für Readonly/Global-Supporter oder bei fehlendem Zugriff
- `403 Active IP limit reached...` wenn Aktivierung dein Quota überschreitet
- `404 IP not found` wenn die IP nicht existiert

## Antwort (Response)

Gibt das aktualisierte Kunden-IP-Objekt zurück. Siehe [Fehlerliste](/de/api/error-codes-and-known-pitfalls) für Fehlerantworten.
