Skip to main content
POST
Import media from a URL

Authorizations

Authorization
string
header
required

Your API key, e.g. sk_live_... or sk_test_....

Headers

Idempotency-Key
string

Optional. Makes this write safe to retry: the same key replays the first response instead of acting twice.

Maximum string length: 255

Body

application/json
url
string
required

http or https.

Maximum string length: 2048
filename
string
Maximum string length: 255
retention
enum<string>
Available options:
provider_only,
managed,
customer_storage,
no_retention
phone_number_id
string
Maximum string length: 64

Response

Imported.

id
string | null

Meta's media id.

uuid
string
filename
string
mime_type
string
size_bytes
integer
source
string
retention
enum<string>
Available options:
provider_only,
managed,
customer_storage,
no_retention
expires_at
string<date-time> | null

When LazyApp will drop its retained copy.

provider_expires_at
string<date-time> | null

Meta keeps media roughly 30 days.

scan_status
string
access_count
integer
last_accessed_at
string<date-time> | null
access_history
object[]
created_at
string<date-time> | null