Files and media uploads

Editions: Open Source · Free Cloud · Pro · Workers

Media uses secured file REST endpoints (and Admin SDK file helpers), not GraphQL document mutations alone. GraphQL may reference media fields after upload.

Flow

1. Configure storage in project settings (Engine plugin / Cloud defaults).
2. Upload via Console media UI or SDK/REST (/secured/files family — follow your Engine version).
3. Attach returned media ids/urls on model fields.
4. Serve public URLs according to your storage driver’s ACL.

SDK note

JS Admin SDK documents file helpers separately from the five model ops. Do not invent GraphQL uploadFile mutations unless your published schema exposes them.

Hygiene

• Scan untrusted uploads at the edge if you accept public contributions.
• Do not commit binary assets into Blueprint repos.

Next

• Auth
• JS SDK
• Troubleshooting