Deutsch English

Ankündigung anlegen

POST /api/v1/announcements

Beide Grenzen sind optional: kein Start bedeutet „ab sofort“, kein Ende „bis zur Entfernung“.

Erforderliche Berechtigung

announcements.manage Ankündigungen verwalten

Body Parameter (application/json)

Name Format Beschreibung Optional
title string Locale-Objekt, z. B. {"de": "Störung", "en": "Outage"}. Bei PATCH partiell; ein explizites null löscht die Übersetzung. —
body string Locale-Objekt wie bei title. Markdown erlaubt.
level
dismissible boolean
starts_at string Ohne Angabe unbegrenzt.
ends_at string Exklusiv. Ohne Angabe unbegrenzt.

Response (application/json) 

{1 Eigenschaft
  "data": {10 Eigenschaften
    "id": "01kyhjx7hxggqfaekf2b5sy61x",
    "title": {2 Eigenschaften
      "de": "Wartungsfenster am Sonntag",
      "en": "Maintenance window on Sunday"
    },
    "body": {2 Eigenschaften
      "de": "Zwischen 02:00 und 04:00 Uhr kann es zu kurzen Unterbrechungen kommen.",
      "en": null
    },
    "level": "warning",
    "dismissible": true,
    "starts_at": null,
    "ends_at": "2026-08-03T00:00:00Z",
    "is_active": true,
    "created_at": "2026-07-27T14:00:00Z",
    "updated_at": "2026-07-27T14:00:00Z"
  }
}
{2 Eigenschaften
  "message": "The title field must be filled in at least one language (de, en).",
  "errors": {1 Eigenschaft
    "title": [1 Element
      "The title field must be filled in at least one language (de, en)."
    ]
  }
}

cURL

curl -X POST 'https://status.example.com/api/v1/announcements' \
  -H 'Authorization: Bearer fs_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"title":"VALUE","body":"VALUE","level":"VALUE","dismissible":"VALUE","starts_at":"VALUE","ends_at":"VALUE"}'