Skip to main content
POST
Upload media

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

multipart/form-data
file
file
required
retention
enum<string>
Available options:
provider_only,
managed,
customer_storage,
no_retention
phone_number_id
string
Maximum string length: 64
connection_uuid
string<uuid>

Response

Uploaded.

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