# `media.upload` Stage a binary upload (raw body); commit with catalog.media.commit. - **method + path**: `POST /v1/media/upload` - **TR label**: Medya yükleme - **auth**: authenticated · scope gates: none beyond authentication - **agentPolicy**: `workspace` — writes confined to the caller's own draft workspace or staging — every token kind executes it directly. - **effects**: `r2` - **idempotency**: server — the platform derives the key - **wraps**: — (no command inside) Machine-readable body schema: [/schemas/routes/media.upload.json](/schemas/routes/media.upload.json). ## Body Raw binary body (the file bytes; `content-type` passed through).