post
https://example.com/api/v2/projects//uploads
Uploads files for a turn to attach and returns their staged references
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Step one of attaching files to a turn: upload the bytes here, then pass the returned references as files on Agentic-mode ask. Uploading alone does not hand the file to the agent.
Send multipart/form-data with one or more file parts. Every file in a request shares one server-generated uploadSessionId, so send a turn's attachments in a single request — a files array spanning two upload sessions is rejected with 400.
| Extensions | .csv, .doc, .docx, .pdf, .xls, .xlsx, .sql, .yaml, .yml, .md, .json, .txt, .zip |
| Files per request | 10 |
| Size per file | AGENT_FILE_UPLOAD_MAX_SIZE_MB, default 10 MB — 413 above it |
See Uploads for the full two-step flow.