Files

Files are durable context for agents and builder sessions.

WorldAgents supports organization-scoped workspace files, session attachments, shared skills, splats, previews, and other assets. The server owns storage paths and returns URLs or file references that clients can treat as opaque.

Files are useful for:

• SOPs, policies, manuals, and troubleshooting guides
• exhibit or venue metadata
• inspection checklists and evidence
• images, maps, generated splats, and simulation assets
• summaries or notes created during build and test sessions

The important rule is that durable knowledge should live in the organization workspace, not only inside a temporary chat transcript.

Upload size

A single workspace upload may be up to 1 GB. The body is streamed to disk rather than buffered, so a large splat costs disk, not API memory. Over-limit uploads are rejected with a 413 that names the limit, and the partially received file is discarded rather than left in the workspace.

Set WORLDAGENTS_WORKSPACE_UPLOAD_LIMIT_MB to raise or lower it per environment. This is separate from rawBodyLimit (50 MB), which bounds ordinary JSON and attachment request bodies and does not apply to workspace uploads.