Xagent Docs
Get started

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 100 MB per file. A file over the limit is refused outright rather than partly uploaded. For anything larger, compress to ZIP, split it into smaller files, or reduce image resolution before uploading.

Self-hosted deployments can change this

100 MB is the default. A self-hosted deployment can set a different limit, so if you are not on Xagent Cloud, check with whoever runs it. Separately, how much you can store in total across a team knowledge base is capped by your plan — see Storage Limits.

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.

Troubleshooting

ProblemWhat to do
The file is refused for being too largeThe limit is 100 MB per file. Over that, the upload is rejected outright — nothing is partly saved. Compress to ZIP, split the file, or reduce image resolution and try again.
The file is refused as an unsupported typeXagent accepts a fixed set of file extensions — check yours against Supported Content above. Renaming the extension will not help, since the type is checked, not guessed. Convert to a supported format instead.
The upload is refused with a message about upgradingThis is a storage limit, not a file-size one: your team has reached the total knowledge base capacity on its plan. Deleting files frees space immediately — see Storage Limits.

Next Steps