---
title: "FTP Monitor aktualisieren (Status ändern)"
description: "Aktualisiert einen FTP Monitor und/oder ändert den Status."
---

`PATCH /api/ftp-monitors/:ftpMonitorPublicId`

## Authentifizierung

`Authorization: Bearer <token>`

## Parameter

- `ftpMonitorPublicId` (Pfad, erforderlich): Öffentliche UUID des FTP Monitors.

## Request Body

- `status` (optional): `active`, `maintenance`, `disabled` (akzeptiert auch `inactive`/`paused` und normalisiert zu `disabled`)
- `customerId` (optional, number): Muss zur selben Organisation gehören
- `name` (optional, string)
- `hostname` (optional, string): Muss ein Hostname sein (kein Protokoll, kein Pfad)
- `port` (optional, number | null)
- `checkInterval` (optional, number)
- `timeoutSeconds` (optional, number)
- `allowedCheckCountryCodes` (optional, string[] | null): ISO-3166-1 alpha-2, z.B. `"DE"`, `"ES"`
- `checkMode` (optional, string): `protocol` (Standard) | `tcp`. Beim Wechsel zu `tcp` werden gespeicherte Zugangsdaten gelöscht: der Monitor führt nur eine reine TCP-Port-Erreichbarkeitsprüfung durch und `ftpConfig` wird nicht gespeichert. Beim Zurückwechseln zu `protocol` läuft wieder die vollständige FTP-Login-Prüfung; neue Zugangsdaten über `ftpConfig`/`config` mitschicken.
- `ftpConfig` (optional, object): Ersetzt die gespeicherte FTP-Config (JSON)
- `config` (optional, object): Alias von `ftpConfig`

Hinweis: Read-only Nutzer dürfen nur `status` ändern.

Hinweis: Wenn du `ftpConfig`/`config` weglässt, bleibt die bestehende Config unverändert.

```json
{ "status": "maintenance" }
```

## Beispiel (cURL)

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

curl -X PATCH \
 "$BASE_URL/api/ftp-monitors/55555555-5555-4555-8555-555555555555" \
 -H "Authorization: Bearer $TOKEN" \
 -H "Content-Type: application/json" \
 -d '{"status":"active","allowedCheckCountryCodes":["DE","ES"],"ftpConfig":{"user":"monitor","password":"<ftp-password>","secure":false}}'
```

## Response

```json
{
 "id": 400,
 "status": "maintenance",
 "config": {},
 "ftpConfig": {}
}
```

## Häufige Fehler

- `400 Invalid status` wenn `status` ungültig ist
- `401 Unauthorized` wenn du nicht authentifiziert bist
- `403 Forbidden` wenn du keine Schreibrechte hast (z.B. Read-only versucht andere Felder zu ändern, oder Global Supporter)
- `404 FTP monitor not found` wenn der Monitor nicht existiert