File Upload

Upload files to a task workspace so agents can access and process them during execution.

Upload Methods

  • From the Task page — click the attachment icon, select files, and they are attached to your task request. Multiple files at once are supported.
  • Drag and drop — drag files from your file manager onto the task input area to attach them automatically.

Supported Content

  • Documents — PDF, DOCX, TXT, Markdown, HTML
  • Presentations — PPTX
  • Spreadsheets — CSV, XLSX
  • Data — JSON
  • Images — PNG, JPG
  • Code files and more

File Size Limits

Maximum file size is typically 10–100MB per file, and total upload size varies by configuration and plan. For large files, compress to ZIP, split into smaller chunks, or reduce image resolution.

Limits vary

Upload limits depend on your Xagent configuration and plan. Contact your administrator for the exact limits in your deployment.

Upload via API

POST /api/files/upload            # multipart/form-data file upload

An uploaded file's id can then be passed when creating a task.

Next Steps