List files

GET/chat-rooms/:roomId/files

List the chat room's file library. Folders and files are returned in a single items array sorted by name regardless of type, together with breadcrumbs. Omit folderId for the root. There is no pagination: the whole contents of the folder are returned.

Auth	Login required

Path parameters

roomIdstringrequired

Chat room ID.

Query parameters

folderIdstring

Folder to list. Omit for the root.

qstring

Partial name match within the current folder.

Response

Field	Type	Description
`folder`	object	The folder being listed; null at the root.
`breadcrumbs`	object[]	Ancestors from the root, including the folder itself.
`items`	object[]	Array of entries with type folder or file, sorted by name regardless of type.

curl https://api.4s.link/chat-rooms/ROOM_ID/files \
  -H "Authorization: Bearer 4s_at_..."

Example response
{
  "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" }
  ]
}