---
title: "Change Request anlegen"
description: "Eröffnet einen Change Request gegen einen beliebigen Monitor (alle Monitor-Typen)."
---

`POST /api/monitors/:monitorType/:monitorId/change-requests`

Lesezugriff auf den Monitor genügt. Der typische Aufrufer ist ein Kundenportal-Nutzer, der auf einem `managed`-Monitor *keinen* Schreibzugriff hat.

## Pfad-Parameter

| Parameter | Beschreibung |
|---|---|
| `monitorType` | Einer von `website`, `dns`, `icmp`, `smtp`, `ssh`, `ftp`, `imap_pop`, `domain`, `dnsbl` |
| `monitorId` | Numerische ID des Monitors |

## Request Body

| Feld | Typ | Pflicht | Standard | Beschreibung |
|------|-----|---------|----------|--------------|
| `kind` | string | Nein | `change` | `change` (Freitext-Wunsch) oder `request_managed` (die Org bitten, den Monitor zu übernehmen) |
| `message` | string | Ja | - | Der Anfragetext (1-2000 Zeichen) |

## Beispiel (cURL)

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

curl -X POST "$BASE_URL/api/monitors/website/103/change-requests" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "change",
    "message": "Bitte das Check-Intervall auf 1 Minute senken."
  }'
```

## Response

```json
{
  "id": 12,
  "status": "open"
}
```

## Häufige Fehler

- `400 Invalid monitor type` (`invalidMonitorType`), wenn `monitorType` keiner der unterstützten Typen ist
- `400 Invalid monitor identifier`, wenn `monitorId` keine positive Ganzzahl ist
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden` / `404 Not found`, wenn der Monitor außerhalb deines Scopes liegt
- `429 Too many open requests` (`tooManyOpenRequests`), wenn der Kunde bereits 10 offene Anfragen hat