イベントを更新
/manage/events/:eventIdイベント情報を更新します。eventWrite 権限が必要です(ミーティング設定のみの更新は eventMeetingWrite でも可)。主催者(EventOrganizer)は organizers 配列で一括更新され、配列に含まれない主催者は削除されます。
| 認証 | 要ログイン |
|---|
パスパラメータ
eventIdstring必須イベント ID または slug。
リクエストボディ
titlestringイベント名(必須)。文字数制限なし。
descriptionstring説明(Markdown)。文字数制限なし。
languagesobject多言語のタイトル・説明。
eventTypestringONSITE / ONLINE / HYBRID のいずれか(作成時は必須)
timezonestringIANA タイムゾーン(例: Asia/Tokyo)
schedulesobject[]開催日ごとの日程の配列。各要素は date(YYYY-MM-DD)・startTime / endTime(HH:mm)を持ち、doorTime(開場時刻)は任意。時刻はイベントの timezone で解釈される。
locationobject開催場所。
onlineUrl / onlineDescriptionstringオンライン開催の URL(有効な URL 形式)と説明(200 文字以内)
enabledTickets / enabledSideEventsbooleanチケット販売・サイドイベントの有効化フラグ。イベント管理者が変更できるのはこの 2 つのみ。
slugstring3〜200 文字。半角英小文字・数字・ハイフン・アンダースコアのみ(^[a-z0-9-_]+$)。重複不可。
thumbnailUrl / mainImageUrlstring画像 URL。有効な URL 形式であること。アップロード系エンドポイントが返した URL を指定する。
customStyle / customNavigationobjectカスタムスタイル・ナビゲーション。
organizerContactobject主催者の連絡先。
tagsstring[]タグ名の配列。
statestringDRAFT / PUBLISHED / PRIVATE / CANCELED のいずれか。CANCELED への変更はプラットフォーム運営(platformAdmin)のみ可能。
organizersobject[]主催者(EventOrganizer)の全量。配列に無い主催者は削除される。
requiresApproval / registrationPaused / requiresFacePhotoboolean参加登録の挙動。
maxParticipantsnumber参加人数の上限。1 以上の整数。
participantListVisibilitystringPUBLIC / PARTICIPANTS_ONLY / PRIVATE のいずれか。
participantCancellationPolicyobjectDISABLED(キャンセル不可) / 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表示用のテキスト。
placeIdstringGoogle 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": []}