Uptimeify Docs

Domain abfragen

Gibt eine eigene App-Domain deiner Organisation zurück, in derselben Form { domain, dns } wie beim Hinzufügen. Erfordert die Admin-Rolle.

GET /api/organization/whitelabel/domains/{id}

Zugriff

Nur Organisations-Admins, wie bei Domains auflisten. Zurück kommen nur Domains mit der Rolle app.

Beispiel (cURL)

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

curl -X GET "$BASE_URL/api/organization/whitelabel/domains/3" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)

200 OK

{
  "domain": {
    "id": 3,
    "hostname": "monitoring.acme.example",
    "status": "active",
    "role": "app",
    "isPrimary": true,
    "verificationToken": "uptimeify-verify-def456",
    "verifiedAt": "2026-06-02T08:00:00.000Z",
    "createdAt": "2026-06-01T08:00:00.000Z",
    "updatedAt": "2026-06-02T08:00:00.000Z"
  },
  "dns": {
    "txtName": "_verify-status.monitoring.acme.example",
    "txtValue": "uptimeify-verify-def456"
  }
}

Häufige Fehler

  • 400 Bad Request (invalidDomainId), wenn die ID keine positive Zahl ist
  • 401 Unauthorized, wenn du nicht angemeldet bist
  • 403 Forbidden, wenn du kein Organisations-Admin bist
  • 404 Not Found (domainNotFound), wenn die Domain nicht existiert oder zu einer anderen Organisation gehört

Auf dieser Seite