イベントを更新

PUT/manage/events/:eventId

イベント情報を更新します。eventWrite 権限が必要です(ミーティング設定のみの更新は eventMeetingWrite でも可)。主催者(EventOrganizer)は organizers 配列で一括更新され、配列に含まれない主催者は削除されます。

認証要ログイン

パスパラメータ

eventIdstring必須

イベント ID または slug。

リクエストボディ

titlestring

イベント名(必須)。文字数制限なし。

descriptionstring

説明(Markdown)。文字数制限なし。

languagesobject

多言語のタイトル・説明。

eventTypestring

ONSITE / ONLINE / HYBRID のいずれか(作成時は必須)

timezonestring

IANA タイムゾーン(例: Asia/Tokyo)

schedulesobject[]

開催日ごとの日程の配列。各要素は date(YYYY-MM-DD)・startTime / endTime(HH:mm)を持ち、doorTime(開場時刻)は任意。時刻はイベントの timezone で解釈される。

locationobject

開催場所。

onlineUrl / onlineDescriptionstring

オンライン開催の URL(有効な URL 形式)と説明(200 文字以内)

enabledTickets / enabledSideEventsboolean

チケット販売・サイドイベントの有効化フラグ。イベント管理者が変更できるのはこの 2 つのみ。

slugstring

3〜200 文字。半角英小文字・数字・ハイフン・アンダースコアのみ(^[a-z0-9-_]+$)。重複不可。

thumbnailUrl / mainImageUrlstring

画像 URL。有効な URL 形式であること。アップロード系エンドポイントが返した URL を指定する。

customStyle / customNavigationobject

カスタムスタイル・ナビゲーション。

organizerContactobject

主催者の連絡先。

tagsstring[]

タグ名の配列。

statestring

DRAFT / PUBLISHED / PRIVATE / CANCELED のいずれか。CANCELED への変更はプラットフォーム運営(platformAdmin)のみ可能。

organizersobject[]

主催者(EventOrganizer)の全量。配列に無い主催者は削除される。

requiresApproval / registrationPaused / requiresFacePhotoboolean

参加登録の挙動。

maxParticipantsnumber

参加人数の上限。1 以上の整数。

participantListVisibilitystring

PUBLIC / PARTICIPANTS_ONLY / PRIVATE のいずれか。

participantCancellationPolicyobject

DISABLED(キャンセル不可) / FREE_ONLY(無料チケットのみ) / NON_PREPAID(事前決済以外)のいずれか。

entryProfileFieldsobject

参加登録時に収集するプロフィール項目。

ga4MeasurementId / metaPixelIdstring

計測タグ ID。各 20 文字以内。

オブジェクトの構造

schedules

開催日ごとの日程。日付と時刻は分けて指定し、時刻はイベントの timezone で解釈されます。

datestring必須

開催日。YYYY-MM-DD 形式。

doorTimestring

開場時刻。HH:mm 形式。

startTimestring必須

開始時刻。HH:mm 形式。

endTimestring必須

終了時刻。HH:mm 形式。

[
  { "date": "2026-09-01", "doorTime": "09:30", "startTime": "10:00", "endTime": "18:00" }
]

location

会場情報。単一のオブジェクト、または複数会場を表すオブジェクトの配列を指定できます。

name / titlestring

会場名・表示ラベル。

displayTextstring

表示用のテキスト。

placeIdstring

Google Places の場所 ID。

zipCode / country / countryCode / state / city / address / buildingstring

住所の各要素。

geoobject

座標(lat / lng)

websiteUrl / telstring

会場のウェブサイト・電話番号。

descriptionstring

会場の補足説明。

primaryboolean

複数会場のうち主要な会場か。

{
  "name": "4S Hall",
  "displayText": "東京都渋谷区...",
  "countryCode": "JP",
  "geo": { "lat": 35.6595, "lng": 139.7005 },
  "primary": true
}

languages

言語コードをキーに、その言語で表示する title / description を指定します。指定した言語のみ上書きされ、未指定の言語は既定のフィールドが使われます。

<lang>object

言語コード(ja / en など)

<lang>.titlestring

その言語で表示するタイトル。

<lang>.descriptionstring

その言語で表示する説明。

{
  "ja": { "title": "オープニング基調講演", "description": "..." },
  "en": { "title": "Opening Keynote", "description": "..." }
}

contact / organizerContact

連絡先。オブジェクトの配列(最大 10 件)で指定します。後方互換のため単一オブジェクトも受け付けます。

labelstring

表示ラベル(例: お問い合わせ窓口)

emailstring

メールアドレス。

urlstring

問い合わせフォームなどの URL。

x / instagram / facebook / youtubestring

公式 SNS。

languagesobject

言語別ラベル({ [lang]: { label } })

[
  {
    "label": "お問い合わせ",
    "email": "contact@example.com",
    "languages": { "en": { "label": "Contact" } }
  }
]

補足

OAuth アクセストークンでアクセスした場合、レスポンス JSON から email フィールドが再帰的に除去されます(セッション認証の管理画面では除去されません)。

enabledMeetings(ミーティング)/ enabledChat(チャット)/ enabledReferralTree(リファラルツリー・招待機能)/ enabledConferenceMode(カンファレンスモード)は、プラットフォーム運営用の admin API でのみ有効化できます。このエンドポイントのリクエストに含めても無視され、作成時は常に false になります。イベント管理者が変更できる機能フラグは enabledTickets(チケット販売)と enabledSideEvents(サイドイベント)のみです。現在の値は GET /manage/events/:eventId のレスポンスで確認できます。

リクエスト
curl https://api.4s.link/manage/events/EVENT_ID \
-X PUT \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"title": "4S Tech Conference 2026",
"state": "PUBLISHED",
"organizers": [
{ "communityId": "c1a2b3c4-..." }
]
}'
レスポンス例
{
"id": "e1f2a3b4-...",
"slug": "tech-conf-2026",
"title": "4S Tech Conference 2026",
"description": "...",
"state": "DRAFT",
"eventType": "HYBRID",
"timezone": "Asia/Tokyo",
"schedules": [
{ "date": "2026-09-01", "doorTime": "09:30", "startTime": "10:00", "endTime": "18:00" }
],
"location": { "displayText": "Tokyo, Japan" },
"thumbnailUrl": "https://.../thumb.png",
"organizers": [
{ "id": "eo1a2b3-...", "communityId": "c1a2b3c4-...", "userId": null }
],
"tags": []
}