How does an agent know that an upload finished?
It calls workspace_uploads_get until state is ready or rejected.
When ready, fileID and versionID name the new file and its version.
When rejected, rejectReason says why.
More: MCP, Worked examples