List files

List durable Files visible to the caller. This Tool is not Runtime-bound; use the Files resource client when you need relationship filters.

List Files

1
const result = await bctrl.tools.call("files.list", {
2
  prefix: "reports/",
3
  limit: 50,
4
});
5
6
for (const file of result.files) {
7
  console.log(file.id, file.name, file.size);
8
}
9
console.log(result.nextCursor);

This Tool is synchronous. Use the Files resource client when you need upload, download, update, or delete operations.

Request parameters

Response

The result is { files, nextCursor }:

Next

• Files — manage durable File resources
• Read text — read bounded UTF-8 content
• Runtime files — inspect a live workspace