Deutsch English

Veröffentlichen

POST /api/v1/maintenances/{incident}/publish

Kündigt das Fenster den Abonnenten an, sofern notify nicht false ist. Bei bereits veröffentlichtem Fenster folgt 409.

Erforderliche Berechtigung

incidents.manage Vorfälle und Wartungen verwalten

URL Variablen

Name Beschreibung
incident Numerische ID des Vorfalls oder Wartungsfensters. Beide Sammlungen liegen auf einem Modell — deshalb heißt der Platzhalter auch auf den Wartungs-Routen {incident}.

Body Parameter (application/json)

Name Format Beschreibung Optional
at String Datiert den Veröffentlichungs-Zeitstempel zurück.
notify Boolean

Beispiel-Request (application/json) 

{
  "at": "2026-07-27T14:00:00Z",
  "notify": true
}

Werte sind Beispiele — Pflichtfelder stehen in der Tabelle. Der Body wird als JSON gesendet.

Response (application/json) 

{1 Eigenschaft
  "data": {20 Eigenschaften
    "id": 12,
    "type": "incident",
    "status": "investigating",
    "title": {2 Eigenschaften
      "de": "Störung im Netz",
      "en": "Network issue"
    },
    "body": {2 Eigenschaften
      "de": "Wir untersuchen erhöhte Latenzen.",
      "en": null
    },
    "started_at": "2026-07-27T13:55:00Z",
    "scheduled_end_at": null,
    "published_at": "2026-07-27T14:00:00Z",
    "publish_at": "2026-07-27T14:00:00Z",
    "resolved_at": null,
    "acknowledged_at": null,
    "is_published": true,
    "is_scheduled": false,
    "is_resolved": false,
    "components": [1 Element
      {2 Eigenschaften
        "id": 3,
        "impact": "degraded"
      }
    ],
    "public_url": "https://status.example.com/incidents/12",
    "postmortem": null,
    "updates": [],
    "created_at": "2026-07-27T14:00:00Z",
    "updated_at": "2026-07-27T14:00:00Z"
  }
}
{2 Eigenschaften
  "message": "Maintenance is already published.",
  "documentation_url": "https://docs.firestatus.de"
}
{2 Eigenschaften
  "message": "This API accepts JSON only. Send the request body as application/json (received application/x-www-form-urlencoded).",
  "documentation_url": "https://docs.firestatus.de"
}

cURL

curl -X POST 'https://status.example.com/api/v1/maintenances/{incident}/publish' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"at":"2026-07-27T14:00:00Z","notify":true}'