チャットルームを作成
POST
/chat-roomsチャットルームを作成します。自分を含めて 2 人なら DIRECT、3 人以上なら GROUP になります。DIRECT で既存のルームがある場合はそれを返します。initialMessage は任意で、指定すると最初のメッセージも作成されます。**新規作成時は「作成しました」のシステムメッセージが必ず 1 行入ります**(initialMessage の有無にかかわらず。既存の DIRECT ルームを返す場合は入りません)。
| 認証 | 要ログイン |
|---|
リクエストボディ
memberIdsstring[]必須自分以外のメンバーのユーザー ID の配列(必須)。1 件以上を指定する。
namestringルーム名(GROUP の場合)
initialMessagestring最初に送信するメッセージ。
リクエスト
curl https://api.4s.link/chat-rooms \-X POST \-H "Authorization: Bearer 4s_at_..." \-H "Content-Type: application/json" \-d '{"memberIds": ["a1b2c3d4-..."],"initialMessage": "よろしくお願いします"}'
レスポンス例
{"id": "r1a2b3c4-...","type": "GROUP","name": "Project Team","members": [{"id": "rm1a2b3-...","status": "JOINED","user": { "id": "a1b2c3d4-...", "slug": "taro", "firstName": "太郎", "lastName": "山田", "avatarUrl": "https://.../avatar.png" }}],"lastMessage": { "id": "m1a2b3c4-...", "content": "よろしくお願いします", "createdAt": "2026-08-18T00:00:00.000Z" },"unreadCount": 0}