Uptimeify Docs
OrganisationBerichte

Bericht sofort senden

Stellt eine sofortige, außerplanmäßige Erzeugung und Zustellung eines Organisationsberichts in die Warteschlange.

POST /api/organization/reports/:id/send-now

Stellt einen manuellen Lauf einer Berichtskonfiguration in die Warteschlange, unabhängig von deren frequency/sendHour-Zeitplan. :id ist die id des Berichts (eine UUID). Die Organisation wird aus Ihrer authentifizierten Sitzung oder Ihrem API-Token abgeleitet, und der Bericht muss zu ihr gehören. Erfordert die Rolle admin der Organisation (API-Tokens gelten als Organisations-Admins). Nur-Lese-Benutzer können keinen Versand auslösen.

Dieser Endpoint stellt den Job nur in die Warteschlange — er wartet nicht auf Erzeugung oder Zustellung. Fragen Sie Bericht-Läufe auflisten (gefiltert nach reportId) ab, um den resultierenden Lauf zu sehen, sobald dessen status über pending hinausgeht.

Beispiel (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<ihr-api-token>"
REPORT_ID="3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90"

curl -X POST "$BASE_URL/api/organization/reports/$REPORT_ID/send-now" \
  -H "Authorization: Bearer $TOKEN"

Antwort

{
  "queued": true,
  "jobId": "orgreport-manual-3f1c9c1e-8d2a-4c7e-9b1a-2d5f6a7b8c90-1b6e..."
}

Häufige Fehler

  • 401 Unauthorized — nicht authentifiziert.
  • 403 Forbidden (forbidden) — kein Organisations-Admin.
  • 404 Not Found (notFound) — es existiert kein Bericht mit dieser ID für Ihre Organisation.

Auf dieser Seite