Skip to main content
Use video handling when your app needs to upload video files for posts, messages, stories, clips, or other media experiences. Video uploads return a video file object with a fileId, original URL, and, on platforms that expose it, transcoding status and a map of generated resolution URLs. The SDK exposes upload progress and video file metadata. Playback UI, caching, retry policy, and adaptive player behavior remain application concerns.

Platform Surface

Parameters

Upload A Video

Upload a video first, then use the returned video object or fileId in video-based content APIs.

Read Video Status And URLs

Read video status and resolution URLs when your UI needs to render playback or processing state. The returned video file also carries the frame dimensions, but each platform surfaces them differently — see the Frame dimensions column above for the accessor and the minimum SDK version. Width and height are the stored (pre-rotation) values. Apply the rotation to get the displayed orientation: swap width and height when rotation % 180 != 0.
Flutter exposes the stored width and height but no rotation. Width and height alone cannot determine the display orientation of a rotated video; use a media player or parser that handles orientation metadata.

Video Posts

Attach uploaded videos to social posts.

File Handling

Upload and inspect generic file attachments.

Clip Posts

Create short-form clip posts where supported.