API リファレンス
イベント（管理者用）
- GET
/manage/events管理できるイベント一覧（管理者用）認証中ユーザーがスタッフとして参加しているイベントの一覧を返します。 - GET
/manage/events/:eventIdイベント詳細（管理者用）管理用のイベント情報を取得します。eventRead 権限を持つスタッフのみアクセスできます。 - POST
/manage/eventsイベントを作成（管理者用）イベントを DRAFT 状態で作成します。作成者は自動的に ADMIN スタッフとして登録されます。権限チェックはなく、ログイン中のユーザーであれば作成できます。主催者（EventOrganizer）は organizers で指定します。 - PUT
/manage/events/:eventIdイベントを更新（管理者用）イベント情報を更新します。eventWrite 権限が必要です（ミーティング設定のみの更新は eventMeetingWrite でも可）。主催者（EventOrganizer）は organizers 配列で一括更新され、配列に含まれない主催者は削除されます。 - DELETE
/manage/events/:eventIdイベントを削除（管理者用）イベントを削除します。eventWrite 権限が必要です。 - GET
/manage/events/:eventId/acl自分のスタッフロールと権限（管理者用）認証中ユーザーのそのイベントにおけるスタッフロールと、ロールごとの権限一覧を返します。管理 UI の表示制御に使います。 - PUT
/manage/events/:eventId/thumbnailサムネイル画像をアップロード（管理者用）イベントのサムネイル画像をアップロードします。eventWrite 権限が必要です。 - PUT
/manage/events/:eventId/main-imageメイン画像をアップロード（管理者用）イベントページのメイン画像をアップロードします。eventWrite 権限が必要です。 - POST
/manage/events/:eventId/description-images説明文用の画像をアップロード（管理者用）イベント説明文（Markdown）に埋め込む画像をアップロードし、URL を返します。eventWrite 権限が必要です。 - GET
/manage/events/:eventId/staffイベントスタッフ一覧（管理者用）イベントスタッフの一覧を返します。staffRead 権限が必要です。 - POST
/manage/events/:eventId/staffイベントスタッフを追加（管理者用）既存ユーザーをイベントスタッフとして追加します。staffInviteWrite または staffWrite 権限が必要です。 - PUT
/manage/events/:eventId/staff/:staffIdイベントスタッフのロールを変更（管理者用）スタッフのロールを変更します。staffWrite 権限が必要です。 - DELETE
/manage/events/:eventId/staff/:staffIdイベントスタッフを削除（管理者用）イベントスタッフを削除します。staffWrite 権限が必要です。 - GET
/manage/events/:eventId/stagesステージ一覧（管理者用）管理用のステージ一覧を返します。stagesRead 権限が必要です。 - POST
/manage/events/:eventId/stagesステージを作成（管理者用）ステージを作成します。stagesWrite 権限が必要です。 - PUT
/manage/events/:eventId/stages/:stageIdステージを更新（管理者用）ステージを更新します。stagesWrite 権限が必要です。 - DELETE
/manage/events/:eventId/stages/:stageIdステージを削除（管理者用）ステージを削除します。stagesWrite 権限が必要です。 - PUT
/manage/events/:eventId/stages/reorderステージの並び順を変更（管理者用）ステージの表示順を一括で変更します。stagesWrite 権限が必要です。 - GET
/manage/events/:eventId/sessionsセッション一覧（管理者用）下書きを含む全セッションを返します。sessionsRead 権限が必要です。 - GET
/manage/events/:eventId/sessions/:idセッション詳細（管理者用）管理用のセッション詳細を返します。sessionsRead 権限が必要です。 - POST
/manage/events/:eventId/sessionsセッションを作成（管理者用）セッションを作成します。sessionsWrite 権限が必要です。SessionSpeaker（登壇者との紐づけ）は entryIds / speakers から作成されます。 - PUT
/manage/events/:eventId/sessions/:idセッションを更新（管理者用）セッションを更新します。sessionsWrite 権限が必要です。entryIds を送ると SessionSpeaker が配列の内容に合わせて作成・削除されます。 - DELETE
/manage/events/:eventId/sessions/:idセッションを削除（管理者用）セッションを削除します。SessionSpeaker も併せて削除されます。sessionsWrite 権限が必要です。 - PUT
/manage/events/:eventId/sessions/bulkセッションを一括更新（管理者用）複数セッションをまとめて更新します。タイムテーブルのドラッグ操作などで使います。sessionsWrite 権限が必要です。 - GET
/manage/events/:eventId/speakers登壇者一覧（管理者用）下書きを含む全登壇者を返します。speakersRead 権限が必要です。登壇者は「登壇者メタデータ付きの参加登録」で、id は参加登録（EventEntry）の ID です。 - GET
/manage/events/:eventId/speakers/:entryId登壇者詳細（管理者用）管理用の登壇者詳細を返します。確定した登壇セッション（sessions）を含みます。speakersRead 権限が必要です。 - POST
/manage/events/:eventId/speakers4S ユーザーを登壇者にする（管理者用）4S ユーザーを登壇者として登録します。speakersWrite 権限が必要です。既に有効な参加登録があればそれに登壇者メタデータを付け、無ければ参加登録を作成します（追加直後は下書き = UNUSED）。代理登録ゲストは指定できません（ゲストは /speakers/guest で作成します）。 - PUT
/manage/events/:eventId/speakers/:entryId登壇者を更新（管理者用）登壇者メタデータ（ピックアップ・表示上書き）を更新します。ゲスト登壇者は guestProfile でユーザー情報も更新できます。speakersWrite 権限が必要です。 - DELETE
/manage/events/:eventId/speakers/:entryId登壇者から外す（管理者用）4S ユーザーの登壇者は登壇者メタデータとセッションの登壇割り当てを削除し、参加登録は残します。ゲスト登壇者は参加登録とゲストユーザーも削除します。speakersWrite 権限が必要です。 - POST
/manage/events/:eventId/speakers/guestゲスト登壇者を作成（管理者用）4S に登録していない登壇者を代理登録ゲスト（ログイン不可・公開プロフィール無し）として作成し、参加登録（下書き = UNUSED）と登壇者メタデータを同時に作成します。speakersWrite 権限が必要です。メールは任意で、ゲストにメールは送信されません。 - POST
/manage/events/:eventId/speakers/order登壇者の並び順を変更（管理者用）登壇者の表示順を一括で変更します。speakersWrite 権限が必要です。 - POST
/manage/events/:eventId/speakers/avatar登壇者の表示用アバターをアップロード（管理者用）このイベント向けの表示上書き用アバター画像をアップロードし、URL を返します。返った URL を overrides.avatarUrl に指定します。speakersWrite 権限が必要です。 - POST
/manage/events/:eventId/speakers/:entryId/guest-avatarゲスト登壇者のアバターを更新（管理者用）代理登録ゲストのプロフィール画像（ユーザー情報の avatarUrl）を更新します。ゲストは表示上書きを持たないため、アバターの上書きは消えます。4S ユーザーの登壇者には使えません（ENTRY_NOT_GUEST）。speakersWrite 権限が必要です。 - GET
/manage/events/:eventId/ticketsチケット一覧（管理者用）販売状況を含む全チケット種別を返します。ticketsRead 権限が必要です。 - POST
/manage/events/:eventId/ticketsチケットを作成（管理者用）チケット種別を作成します。ticketsWrite 権限が必要です。有料チケットには price と paymentType の指定が必要で、Stripe Connect の設定が済んでいる必要があります。 - PUT
/manage/events/:eventId/tickets/:ticketIdチケットを更新（管理者用）チケット種別を更新します。ticketsWrite 権限が必要です。price と paymentType は販売開始後に変更できません。 - DELETE
/manage/events/:eventId/tickets/:ticketIdチケットを削除（管理者用）チケット種別を削除します。既に参加登録があるチケットは削除できません。ticketsWrite 権限が必要です。 - POST
/manage/events/:eventId/tickets/orderチケットの並び順を変更（管理者用）チケット種別の表示順を一括で変更します。ticketsWrite 権限が必要です。 - GET
/manage/events/:eventId/announcementsイベントのお知らせ一覧（管理者用）お知らせの一覧を管理用に取得します。announcementsRead 権限が必要です。 - POST
/manage/events/:eventId/announcementsイベントのお知らせを作成（管理者用）参加者向けのお知らせを作成します。announcementsWrite 権限が必要です。targetStates / targetTicketIds で配信対象を絞り込めます（省略時は CONFIRMED + CHECKED_IN の全チケット参加者）。sendEmail は既定で true のため、省略すると対象者へメールが送信されます。 - PUT
/manage/events/:eventId/announcements/:idイベントのお知らせを更新（管理者用）お知らせを更新します。announcementsWrite 権限が必要です。 - DELETE
/manage/events/:eventId/announcements/:idイベントのお知らせを削除（管理者用）お知らせを削除します。announcementsWrite 権限が必要です。 - GET
/manage/events/:eventId/questionsアンケート設問一覧（管理者用）下書きを含む全設問を返します。questionsRead 権限が必要です。 - POST
/manage/events/:eventId/questionsアンケート設問を作成（管理者用）参加登録アンケートの設問を作成します。questionsWrite 権限が必要です。 - PUT
/manage/events/:eventId/questions/:questionIdアンケート設問を更新（管理者用）設問を更新します。questionsWrite 権限が必要です。 - DELETE
/manage/events/:eventId/questions/:questionIdアンケート設問を削除（管理者用）設問を削除します。回答も併せて削除されます。questionsWrite 権限が必要です。 - PUT
/manage/events/:eventId/questions/orders設問の並び順を変更（管理者用）設問の表示順を一括で変更します。questionsWrite 権限が必要です。 - PUT
/manage/events/:eventId/questions/bulk設問を一括更新（管理者用）複数設問をまとめて作成・更新します。アンケートエディタの保存で使います。questionsWrite 権限が必要です。 - GET
/manage/events/:eventId/questions/:questionId/answers設問への回答一覧（管理者用）特定の設問に対する回答の一覧を返します。questionsRead 権限が必要です。 - GET
/manage/events/:eventId/survey-responsesアンケート回答一覧（管理者用）参加者ごとのアンケート回答を横断的に返します。questionsRead 権限が必要です。 - GET
/manage/events/:eventId/question-aggregationアンケート集計（管理者用）選択式設問の回答数を集計して返します。questionsRead 権限が必要です。 - POST
/manage/events/:eventId/meeting-spot-imagesミーティング場所の画像をアップロード（管理者用）ミーティング場所に設定する画像をアップロードし、URL を返します。meetingSpotsWrite 権限が必要です。 - GET
/manage/events/:eventId/meeting-spotsミーティング場所一覧（管理者用）無効なものを含む全ミーティング場所を返します。meetingSpotsRead 権限が必要です。 - POST
/manage/events/:eventId/meeting-spotsミーティング場所を作成（管理者用）ミーティング場所を作成します。meetingSpotsWrite 権限が必要です。 - PUT
/manage/events/:eventId/meeting-spots/:spotIdミーティング場所を更新（管理者用）ミーティング場所を更新します。meetingSpotsWrite 権限が必要です。 - DELETE
/manage/events/:eventId/meeting-spots/:spotIdミーティング場所を削除（管理者用）ミーティング場所を削除します。meetingSpotsWrite 権限が必要です。 - POST
/manage/events/:eventId/meeting-spots/reorderミーティング場所の並び順を変更（管理者用）ミーティング場所の表示順を一括で変更します。meetingSpotsWrite 権限が必要です。 - GET
/manage/events/:eventId/entries参加者一覧（管理者用）イベントの参加登録一覧を返します。participantsRead 権限が必要です。状態・チケット・キーワードで絞り込めます。 - GET
/manage/events/:eventId/entries/:entryId参加者詳細（管理者用）参加登録 1 件の詳細（アンケート回答を含む）を返します。招待チケットのイベントでは、招待者（invitedBy）と招待した人数（invitedCount / inviteLimit）も含みます。participantsRead 権限が必要です。 - POST
/manage/events/:eventId/entries参加者を追加（代理登録）（管理者用）4S ユーザーを参加者として登録します（参加登録は CONFIRMED で作成）。participantsWrite 権限が必要です。既に有効な参加登録がある場合は EVENT_ALREADY_REGISTERED、代理登録ゲストを指定すると USER_IS_GUEST。定員・チケット在庫は自己登録と同じ判定です。 - GET
/manage/events/:eventId/entries/counts参加者数の集計（管理者用）参加状態・チケット別の参加登録数を返します。participantsRead 権限が必要です。 - GET
/manage/events/:eventId/entries/by-checkin-tokenチェックイントークンから参加者を取得（管理者用）参加者の QR コードに含まれるチェックイントークンから参加登録を検索します。受付アプリでの本人照合に使います。participantsRead 権限が必要です。 - GET
/manage/events/:eventId/entries/:entryId/activity-logs参加者の操作履歴（管理者用）参加登録に対する状態変更・チェックインなどの操作履歴を新しい順に返します。ページネーションは無く、その参加登録の全件を返します。participantsRead 権限が必要です。 - PUT
/manage/events/:eventId/entries/:entryId/state参加状態を変更（チェックイン）（管理者用）参加登録の状態を変更します。CHECKED_IN を指定すると受付チェックイン、CANCELED でキャンセル、承認制イベントでは CONFIRMED / REJECTED で承認・却下します。participantsWrite 権限が必要です。 - PUT
/manage/events/:eventId/entries/:entryId/ticket参加者のチケットを変更（管理者用）参加登録に紐づくチケット種別を変更します。差額の決済・返金は行われません。participantsWrite 権限が必要です。 - GET
/manage/events/:eventId/entries/invited-by/search招待者を検索（管理者用）参加者一覧を招待者で絞り込むための候補を検索します。キーワードは空白区切りで AND 検索され、最大 50 件を返します。participantsRead 権限が必要です。 - POST
/manage/events/:eventId/stripe-connect/entries/:entryId/refund参加登録を返金（管理者用）Stripe 事前決済の参加登録を全額返金します。返金額は支払い済み額から返金済み額を引いた残額で、リクエストボディは不要です。paymentsWrite 権限（ADMIN）が必要です。 - POST
/manage/events/:eventId/badge-printバッジラベルを印刷（管理者用）enavle 連携が有効なイベントで、受付端末からバッジラベルを印刷します。participantsWrite または speakersWrite 権限が必要です。 - GET
/manage/events/:eventId/label-print方式・プリンター・ステーション状態を取得（管理者用）方式・プリンター・ステーション状態を取得。 - PUT
/manage/events/:eventId/label-printラベル印刷機能を切り替える（管理者用）イベントのBrotherラベル印刷機能をON／OFFにします。eventWrite権限が必要です。 - POST
/manage/events/:eventId/label-print/printersプリンターを登録／更新（eventWrite 必須）（管理者用）プリンターを登録／更新（eventWrite 必須）。 - DELETE
/manage/events/:eventId/label-print/printers/:printerIdプリンター登録を削除（管理者用）eventWrite 必須。印刷履歴を保持して登録を削除し、準備済み・待機中のジョブを取り消します。共用受信中、取得済み・印刷中・結果不明のジョブがある場合は409を返します。同じシリアル番号を再登録できます。 - POST
/manage/events/:eventId/label-print/printers/:printerId/station受信開始・10秒 heartbeat・停止（管理者用）受信開始・10秒 heartbeat・停止。 - POST
/manage/events/:eventId/label-print/printers/:printerId/claim物理プリンターの排他取得（管理者用）物理プリンターの排他取得。 - POST
/manage/events/:eventId/label-print/preview履歴を作らずラベルをプレビュー（管理者用）認証とイベント管理権限が必要。entryId省略時はeventWriteも必要。プレビューのみではジョブ・履歴・有効期限を作成しません。返却されたpreviewHashを印刷ボタン押下時のジョブ作成に渡してください。 - GET
/manage/events/:eventId/label-print/jobs直近100件または未解決ジョブを取得（管理者用）直近100件または未解決ジョブを取得。 - GET
/manage/events/:eventId/label-print/jobs/:jobIdジョブ状態を取得（管理者用）ジョブ状態を取得。 - POST
/manage/events/:eventId/label-print/jobsラベル画像・媒体を固定したジョブを準備（管理者用）ラベル画像・媒体を固定したジョブを準備。 - GET
/manage/events/:eventId/label-print/jobs/:jobId/content認証付きスナップショット取得（作成後24時間まで）（管理者用）認証付きスナップショット取得（作成後24時間まで）。 - POST
/manage/events/:eventId/label-print/jobs/:jobId/submitプレビュー済みジョブを実行待ちにする（管理者用）プレビュー済みジョブを実行待ちにする。 - POST
/manage/events/:eventId/label-print/jobs/:jobId/transition送信開始・完了報告・取消・現物確認（管理者用）送信開始・完了報告・取消・現物確認。 - GET
/manage/events/:eventId/dashboard/participants-summary参加状態別の件数（管理者用）参加登録を状態別に集計した件数を返します。7 つの状態すべてがキーとして含まれ、該当が無い状態は 0 になります。participantsRead 権限が必要です。 - GET
/manage/events/:eventId/dashboard/participants-trend参加登録の推移（管理者用）指定期間の参加登録数の推移を返します。data は状態別の各区間の件数、total は参加確定（CONFIRMED / CHECKED_IN）の累計です。participantsRead 権限が必要です。 - GET
/manage/events/:eventId/dashboard/participants-analytics参加者の属性集計（管理者用）参加登録時に回答されたプロフィール項目（性別・年代・居住地）の集計を返します。集計対象は PENDING / AWAITING_PAYMENT / CONFIRMED / CHECKED_IN の参加登録で、未回答（unknown）は除外されます。participantsRead 権限が必要です。 - GET
/manage/events/:eventId/dashboard-chartsダッシュボード用アンケート集計（管理者用）ダッシュボードへの表示を有効にした選択式設問（singleSelect / multiSelect / toggle / radioButton）の集計を返します。参加確定（CONFIRMED / CHECKED_IN）の参加者を対象に集計します。dashboardRead 権限が必要です。 - GET
/manage/events/:eventId/meetings/summaryミーティングの集計（管理者用）イベント内のミーティングのリクエスト数・成立数・キャンセル数とメッセージ数を返します。meetingsRead 権限（EDITOR 以上）が必要です。