Benachrichtigungskanäle auflisten

GET /api/notification-channels

Query ParameterAnkerlink kopieren

Beispiel (cURL)Ankerlink kopieren

curl -X GET "$BASE_URL/api/notification-channels?organizationId=1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Antwort (Response)Ankerlink kopieren

[
  {
    "id": 1,
    "organizationId": 1,
    "customerId": null,
    "websiteId": null,
    "type": "email",
    "category": "direct",
    "name": "Ops Email",
    "config": { "email": "ops@deinkunde.com", "to": "Ops Team" },
    "delaySeconds": 0,
    "conditions": null,
    "isActive": true,
    "allowedPackageTypes": null
  },
  {
    "id": 2,
    "organizationId": 1,
    "customerId": null,
    "websiteId": null,
    "type": "slack",
    "category": "integration",
    "name": "Alerts Slack Channel",
    "config": { "webhookUrl": null, "hasWebhookUrl": true, "username": "Uptimeify" },
    "delaySeconds": 0,
    "conditions": null,
    "isActive": true,
    "allowedPackageTypes": null
  }
]

Geheimnisse innerhalb von config werden nie zurückgegeben: Eine Slack-, Discord- oder Teams-Webhook-URL kommt als null zurück, daneben steht hasWebhookUrl: true, siehe „Kanaltypen und Config" auf der Übersichtsseite der Notification Channels.

SichtbarkeitAnkerlink kopieren

Ohne websiteId und ohne customerId hängt es davon ab, wer liest, welche Kanäle zurückkommen:

• Ein uneingeschränkter Leser (Organisations-Admin, globaler Admin sowie ein organisationsgebundenes Agent-Token) erhält die Kanäle auf Organisationsebene, also jene mit customerId: null und websiteId: null.
• Ein kundengebundener Leser (ein readonly-Benutzer oder ein editor mit expliziten Kundenzuweisungen, dazu das für ihn ausgestellte API- oder Agent-Token) erhält zusätzlich die Kanäle seiner eigenen Kunden. Kanäle eines anderen Kunden kommen nie zurück.

Mit customerId kommen die Kanäle dieses Kunden plus die auf Organisationsebene zurück. Mit websiteId kommen zusätzlich die website-eigenen Override-Kanäle zurück.

Häufige FehlerAnkerlink kopieren

• 401 Unauthorized wenn du nicht authentifiziert bist
• 403 Forbidden wenn du auf Kanäle außerhalb deines Scopes zugreifst