English

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

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。

リクエスト
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"
}