Media

Check media compatibility before uploading

Preflight a file against the platforms connected to your workspace and find out which (if any) would reject it by size or format — before you upload or post. Provide ONE of: a public url (we read its size/type via a HEAD request), an existing media_id, or an explicit size_bytes + mime. Use this to warn the user ("this 995 MB video won't post to Instagram") and confirm before uploading.

post/media/check

Request body

urlstring

Public URL of the file to check (HEAD-probed for size + type).

media_idstring

Id of an already-uploaded library item to check.

size_bytesinteger

File size in bytes (use with mime when you already know them).

mimestring

MIME type, e.g. "video/mp4" (use with size_bytes).

Response

Compatibility result

connected_platformsstring[]

compatibleboolean

true when no connected platform would reject the file.

summarystring nullable

One-line human summary, or null when fully compatible.

Changes

No recorded changes to this endpoint across all 1 revision of this API.