アップロードしたファイルを登録

POST/chat-rooms/:roomId/files

S3 に PUT したファイルをライブラリに登録します。実サイズをサーバーが検証し、10MB を超えていれば拒否します。同じフォルダに同名のファイルがある場合は「report (2).pdf」のように採番されます。postToChat を true にすると、チャットにもメッセージとして流れます。

認証	要ログイン

パスパラメータ

roomIdstring必須

チャットルーム ID。

リクエストボディ

uploadKeystring必須

発行 API が返した uploadKey。

fileNamestring必須

表示するファイル名。

folderIdstring任意

保存先フォルダ。省略・null ならルート直下。

postToChatboolean任意

true ならチャットにもメッセージとして流す。

contentstring任意

postToChat のときの本文。

replyToIdstring任意

postToChat のときの返信元メッセージ ID。

レスポンス

ChatLibraryItem を返します。

リクエスト

curl https://api.4s.link/chat-rooms/ROOM_ID/files \
  -X POST \
  -H "Authorization: Bearer 4s_at_..." \
  -H "Content-Type: application/json" \
  -d '{
  "uploadKey": "chat-file-uploads/r1a2b3c4-.../a1b2c3d4-.../....pdf",
  "fileName": "report.pdf",
  "folderId": null,
  "postToChat": true
}'

レスポンス例

{
  "type": "file",
  "id": "cf1a2b3c-...",
  "name": "report.pdf",
  "folderId": null,
  "mimeType": "application/pdf",
  "size": 1234567,
  "messageId": null,
  "createdAt": "2026-08-29T00:00:00.000Z"
}