メッセージを送信

POST/chat-rooms/:roomId/messages

チャットルームにメッセージを送信します。JSON で content を送るとテキストメッセージ、multipart/form-data で file を送ると画像メッセージになります。ルームのメンバーのみ送信できます。

認証要ログイン

パスパラメータ

roomIdstring必須

チャットルーム ID。

リクエストボディ

contentstring

メッセージ本文。テキストメッセージの場合は必須。

filefile

画像ファイル(multipart/form-data で送る場合)

replyToIdstring

返信元のメッセージ ID。同じルームの削除されていないメッセージであること。

mentionsobject[]

@ メンション。`[{ userId, name }]`。**name は content 中の `@name` と一致していること**(一致しないものは無視されます)。userId は GET /chat-rooms/:id/mention-candidates に出てくる相手だけが有効です。1 通あたり 20 人まで(超えると 400)。multipart で送る場合は JSON 文字列にしてください。

リクエスト
curl https://api.4s.link/chat-rooms/ROOM_ID/messages \
-X POST \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"content": "@山田太郎 よろしくお願いします",
"mentions": [{ "userId": "a1b2c3d4-...", "name": "山田太郎" }]
}'
レスポンス例
{
"id": "m1a2b3c4-...",
"type": "USER",
"content": "よろしくお願いします",
"imageUrl": null,
"createdAt": "2026-08-18T00:00:00.000Z",
"user": { "id": "a1b2c3d4-...", "slug": "taro", "firstName": "太郎", "lastName": "山田", "avatarUrl": "https://.../avatar.png" }
}