File Uploads

File uploads allow Synoria apps to work with documents, images, and other supported content as part of AI-powered workflows. Uploaded files can provide additional context for analysis, extraction, summarization, and automated processing. This makes file handling useful for apps such as research assistants, document analysis tools, knowledge systems, and business automation. Always validate files before uploading and apply appropriate access controls when working with sensitive information.

Upload a File

Create an upload request containing the file you want Synoria to process. Server-side uploads are recommended when handling private, confidential, or user-specific content.

import fs from "fs";
import client from "./client.js";

const file = await client.files.upload({
  file: fs.createReadStream("./report.pdf"),
  purpose: "analysis"
});

console.log(file.id);

Reference an Uploaded File

After uploading a file, use its returned identifier when creating an AI request. This allows Synoria to access the file as additional context during processing.

import client from "./client.js";

const response = await client.chat.create({
  model: "axiom-1",
  messages: [
    {
      role: "user",
      content: "Summarize the uploaded report."
    }
  ],
  attachments: [
    {
      file_id: "file_8f92kx"
    }
  ]
});

console.log(response.output);

Validate Files

Validate file types and sizes before sending them to Synoria. Early validation prevents unsupported uploads, reduces unnecessary requests, and creates a more predictable experience for users.

const allowedTypes = [
  "application/pdf",
  "image/png",
  "image/jpeg",
  "text/plain"
];

function validateFile(file) {
  if (!allowedTypes.includes(file.mimetype)) {
    throw new Error("Unsupported file type.");
  }

  if (file.size > 10 * 1024 * 1024) {
    throw new Error("File exceeds the size limit.");
  }

  return true;
}

export { validateFile };

Best Practices

Combine file uploads with Synoria Chat, Vision, and Agents to build richer AI workflows. Protect sensitive files, validate incoming content, and only grant applications the access they require.