Deutsch English

Verlaufseintrag veröffentlichen

POST /api/v1/maintenances/:incident/updates

Wie bei einem Vorfall; ein terminaler Status schließt das Fenster ab.

Erforderliche Berechtigung

incidents.manage Vorfälle und Wartungen verwalten

URL Variablen

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

Body Parameter (application/json)

Name Format Beschreibung Optional
status Status, die ein WARTUNGSFENSTER annehmen kann (IncidentStatus::forType). —
body string Locale-Objekt wie bei title. Markdown erlaubt. —
components string Liste betroffener Komponenten als JSON-Array, je Eintrag {"id": 3, "impact": "degraded"}. Erlaubte Auswirkungen: degraded, partial_outage, major_outage, under_maintenance.
posted_at string
notify boolean

Response (application/json) 

{1 Eigenschaft
  "data": {6 Eigenschaften
    "id": 42,
    "incident_id": 13,
    "status": "in_progress",
    "body": {2 Eigenschaften
      "de": "Wartung hat begonnen.",
      "en": "Maintenance has started."
    },
    "posted_at": "2026-08-02T00:00:00Z",
    "created_at": "2026-08-02T00:00:00Z"
  }
}
{2 Eigenschaften
  "message": "The body field must be filled in at least one language (de, en).",
  "errors": {1 Eigenschaft
    "body": [1 Element
      "The body field must be filled in at least one language (de, en)."
    ]
  }
}

cURL

curl -X POST 'https://status.example.com/api/v1/maintenances/:incident/updates' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"status":"VALUE","body":"VALUE","components":"VALUE","posted_at":"VALUE","notify":"VALUE"}'