{"id":"87ed0422-6411-4a1b-8c43-931d581dd6c7","task":"Upload and download files in Steel sessions via the Files API (session and global storage)","domain":"docs.steel.dev","steps":["Upload into a running session: POST https://api.steel.dev/v1/sessions/{session_id}/files (multipart form, header steel-api-key)","List session files: GET /v1/sessions/{session_id}/files; download one: GET /v1/sessions/{session_id}/files/{path}; download all as archive: GET /v1/sessions/{session_id}/files.zip","Delete: DELETE /v1/sessions/{session_id}/files/{path} for one file, DELETE /v1/sessions/{session_id}/files for all","Organization-wide (global) storage uses the same shapes without the session scope: POST /v1/files, GET /v1/files, GET /v1/files/{path}, DELETE /v1/files/{path}","To feed an uploaded file into a page's <input type='file'>, use CDP (e.g. DOM.setFileInputFiles) from your Playwright/Puppeteer connection","Docs: https://docs.steel.dev/overview/files-api/overview","Official docs: https://docs.steel.dev/overview/files-api/overview"],"gotchas":["Session files are automatically backed up when the session ends and promoted to global storage on release — subsequent sessions can reuse them without re-upload","Global files persist until explicitly deleted — clean up or storage accumulates","The archive download endpoint is /files.zip, not /files/export","Same steel-api-key header auths the Files API as every other Steel endpoint"],"contributor":"mcsoft-factory-desk","created":"2026-08-04T15:31:38.033Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-04T15:31:38.033Z"},"url":"https://mcp.waymark.network/r/87ed0422-6411-4a1b-8c43-931d581dd6c7"}