Organisation aktualisieren

PATCH /api/organization

Anfrage (Request Body)

{
  "name": "Neuer Name",
  "companyName": "Neuer Firmenname",
  "street": "Neue Straße",
  "postalCode": "54321",
  "city": "Neue Stadt",
  "country": "US",
  "vatId": "US123",
  "billingEmail": "neu@example.com",
  "defaultNotificationChannels": {
    "email": true,
    "sms": false,
    "webhook": true,
    "integrations": false
  },
  "defaultNotificationTargets": {
    "email": "both", // customer, organization, both
    "sms": "organization",
    "webhook": "organization",
    "integrations": "customer"
  }
}

Beispiel (cURL)

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

curl -X PATCH "$BASE_URL/api/organization" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "name": "Neuer Name",
    "billingEmail": "neu@example.com"
  }'

Hinweise:

• Die Organisation wird automatisch aus deiner authentifizierten Session bzw. deinem API-Token abgeleitet.
• Die Legacy-Route PATCH /api/organizations/:organizationPublicId bleibt aus Kompatibilitätsgründen weiterhin verfügbar.
• Der plurale org-lose Alias PATCH /api/organizations wird ebenfalls unterstützt.
• Global Admins brauchen für die org-lose Route einen aktiven Organisationskontext in der Session.

Häufige Fehler

• 400 Invalid request body wenn der Payload nicht zum Schema passt
• 400 Organization ID is required in the authenticated session wenn aus Session/Token keine Organisation abgeleitet werden kann
• 401 Unauthorized wenn du nicht angemeldet bist
• 403 Forbidden wenn du keine Admin-Berechtigung zum Aktualisieren der Organisation hast

Antwort (Response)

Gibt das aktualisierte Organisationsobjekt zurück. Siehe Fehlerliste für Fehlerantworten.