English

イベントのお知らせを作成

POST/manage/events/:eventId/announcements

参加者向けのお知らせを作成します。announcementsWrite 権限が必要です。targetStates / targetTicketIds で配信対象を絞り込めます（省略時は CONFIRMED + CHECKED_IN の全チケット参加者）。sendEmail は既定で true のため、省略すると対象者へメールが送信されます。

認証要ログイン

パスパラメータ

eventIdstring必須

イベント ID または slug。

リクエストボディ

titlestring

タイトル。任意。文字数制限なし。

contentstring必須

本文。作成時は必須。文字数制限なし。

targetStatesstring[]

対象とする参加状態の配列。UNUSED / PENDING / AWAITING_PAYMENT / CONFIRMED / CHECKED_IN のいずれかを 1 つ以上指定する。省略時は ["CONFIRMED", "CHECKED_IN"]（参加確定済みと受付済みの参加者）が対象。空配列はバリデーションエラーになる。

targetTicketIdsstring[]

対象とするチケット ID の配列。省略時・空配列なら全チケットが対象。

sendEmailboolean

対象者へメール通知するか。デフォルト true（省略するとメールが送信される）。メールを送りたくない場合は明示的に false を指定する。

リクエスト
curl https://api.4s.link/manage/events/EVENT_ID/announcements \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "title": "会場変更のお知らせ",
  "content": "...",
  "targetStates": ["UNUSED"],
  "sendEmail": false
}'
レスポンス例
{
  "id": "an1a2b3c-...",
  "title": "会場変更のお知らせ",
  "content": "...",
  "targetStates": ["UNUSED", "CHECKED_IN"],
  "targetTicketIds": [],
  "createdAt": "2026-08-18T00:00:00.000Z"
}