English

ファイル一覧

GET/chat-rooms/:roomId/files

チャットルームのファイルライブラリを返します。フォルダとファイルを 1 本の items にまとめ、種別を分けず名前順に並べます。パンくず（breadcrumbs）も同梱します。folderId を省略するとルート直下です。ページネーションは無く、そのフォルダの中身を全件返します。

認証要ログイン

パスパラメータ

roomIdstring必須

チャットルーム ID。

クエリパラメータ

folderIdstring

表示するフォルダ。省略するとルート直下。

qstring

名前の部分一致（現在のフォルダ内のみ）。

レスポンス

フィールド型説明
folderobject表示中のフォルダ。ルート直下なら null。
breadcrumbsobject[]ルート側から順の祖先（対象フォルダ自身を含む）。
itemsobject[]type が folder / file の配列。種別を分けず名前順。
リクエスト
curl https://api.4s.link/chat-rooms/ROOM_ID/files \
  -H "Authorization: Bearer 4s_at_..."
レスポンス例
{
  "folder": { "id": "fd1a2b3c-...", "name": "議事録" },
  "breadcrumbs": [{ "id": "fd1a2b3c-...", "name": "議事録" }],
  "items": [
    { "type": "folder", "id": "fd2a3b4c-...", "name": "01月", "parentId": "fd1a2b3c-...", "createdAt": "2026-08-29T00:00:00.000Z" },
    { "type": "file", "id": "cf1a2b3c-...", "name": "report.pdf", "folderId": "fd1a2b3c-...", "mimeType": "application/pdf", "size": 1234567, "messageId": null, "createdAt": "2026-08-29T00:00:00.000Z" }
  ]
}