イベント

ミーティングのステータスを変更

PUT/meetings/:meetingId/status

承認・拒否・キャンセル・再許可・キャンセル取り消しをまとめて扱います。遷移できるかどうかは現在のステータスと自分の立場で決まります。

認証要ログイン

パスパラメータ

meetingIdstring必須

ミーティング ID。

リクエストボディ

statusstring必須

新しいステータス(REQUESTED / CONFIRMED / CANCELED / REJECTED)。

補足

許可される遷移: REQUESTED → CONFIRMED(承認。toUserId のみ)、REQUESTED → REJECTED(拒否。toUserId のみ)、REJECTED → REQUESTED(再許可。rejectedBy 本人のみ)、REQUESTED / CONFIRMED → CANCELED(双方のいずれか)、CANCELED → キャンセル取り消し(canceledBy 本人のみ。status には CONFIRMED と REQUESTED のどちらを指定してもよく、承認済みだったミーティングは CONFIRMED に、承認前に取り下げたミーティングは REQUESTED に戻ります)。それ以外は 400(errorCode 40006)です。イベントが終了したあとは、どの遷移も 400(errorCode 20001)です。

キャンセルすると場所・時間・テーブル番号が解放され、同じ枠を他のミーティングが使えるようになります。キャンセルを取り消したあとは場所と時間を設定し直してください。

ステータスの変更はチャットルームにシステムメッセージを追加し、相手に通知を送ります。

レスポンス

フィールド型説明
meetingMeeting更新されたミーティング。
リクエスト
curl https://api.4s.link/meetings/MEETING_ID/status \
-X PUT \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"status": "CONFIRMED"
}'
レスポンス例
{
"meeting": {
"id": "mt1a2b3c-...",
"status": "CONFIRMED",
"canceledBy": null,
"rejectedBy": null
}
}