チャットルームを作成

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
}