メッセージを送信
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" }}