---
title: "Eigene Domain hinzufügen"
description: "Fügt einer bestehenden Status-Seite einen eigenen Hostnamen hinzu und gibt den für die Verifizierung nötigen DNS-TXT-Eintrag zurück. Nur Admin."
---

`POST /api/status-pages/domains`

## Request-Body

| Feld | Typ | Pflicht | Beschreibung |
|------|-----|---------|--------------|
| `statusPageId` | number \| string | Ja | Die ID oder publicId der Status-Seite |
| `hostname` | string | Ja | Der eigene Hostname (z.B. `status.deinkunde.com`) |

## Beispiel (cURL)

```bash
curl -X POST "$BASE_URL/api/status-pages/domains" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "statusPageId": 1,
    "hostname": "status.deinkunde.com"
  }'
```

## Antwort

```json
{
  "domain": {
    "id": 42,
    "hostname": "status.deinkunde.com",
    "status": "pending",
    "role": "status_page",
    "verificationToken": "abc123-def456-ghi789",
    "verifiedAt": null,
    "createdAt": "2026-05-01T11:00:00.000Z",
    "updatedAt": "2026-05-01T11:00:00.000Z"
  },
  "dns": {
    "txtName": "_uptimeify-verify.status.deinkunde.com",
    "txtValue": "abc123-def456-ghi789"
  }
}
```

## Häufige Fehler

- `401 Unauthorized`, wenn nicht authentifiziert
- `403 Forbidden`, wenn kein Admin
- `404 Not found`, wenn die Status-Seite nicht existiert
- `409 Conflict`, wenn der Hostname bereits verwendet wird
- `422 Unprocessable Entity`, wenn der Hostname reserviert oder ungültig ist