Deutsch English

Veröffentlichen

POST /api/v1/incidents/:incident/publish

Macht den Vorfall öffentlich und benachrichtigt Abonnenten, sofern notify nicht false ist. Antwortet mit 409, wenn er bereits veröffentlicht ist.

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
at string Datiert den öffentlichen Zeitstempel zurück.
notify boolean

Response (application/json) 

{1 Eigenschaft
  "data": {19 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",
    "updates": [],
    "created_at": "2026-07-27T14:00:00Z",
    "updated_at": "2026-07-27T14:00:00Z"
  }
}
{1 Eigenschaft
  "message": "Incident not found."
}
{1 Eigenschaft
  "message": "Incident is already published."
}

cURL

curl -X POST 'https://status.example.com/api/v1/incidents/:incident/publish' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"at":"VALUE","notify":"VALUE"}'