Skip to main content
POST
Ingest media from a public URL into storage

Authorizations

Authorization
string
header
required

Opaque API key (sk_live_... / sk_test_...)

Body

application/json
url
string<uri>
required

A direct, publicly reachable http(s) link to the media itself. Up to three redirects are followed, each destination re-validated and re-pinned. The file is identified by its BYTES, not by the response Content-Type, so application/octet-stream is accepted for a real image or video and an image/* header on an HTML document is not. Images are limited to 50MB and video to 50MB on this path - use /v1/media/upload-url for anything larger, since it streams straight to storage instead of through the API.

Response

Stored media reference

success
any
required
data
object
required
meta
object
required