Guides

Files

Declare file stores and generate runtime file URLs.

For agents: Declare file stores in resources.files, enforce content type and size expectations, and upload only through ctx.files.

Server Use

const media = ctx.files.store("media");
const file = await media.createUpload(bytes, {
  filename: "hero.png",
  content_type: "image/png"
});
const url = await media.getPublicUrl(file.file_id);

Private stores require an authenticated user or signed URL.