Sign in

v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB
Media

Finalize a presigned upload slot, ingesting the uploaded object into the media library.

Verifies the object exists in S3 (HeadObject), validates its size against the configured maximum, downloads the staged object to the shared local Uploads disk, and runs the SAME ingestion + media-type detection as the multipart upload (malware scan, dimensions, hashing, transcoding, replication) — so a .webapp is registered as a webapp and a video is transcoded. Returns the created media. This call is idempotent — calling it again returns the same media record.

post/media/uploads/{id}/finalize

Path parameters

idstring required

Upload slot id

Response

Returns the created media

namestring nullable

The media name

group_idstring nullable

The group id

tagsstring nullable

The tags associated with this media

advertiser_idstring nullable

The advertiser id. Optional

is_sharedboolean nullable

Is this media shared with other accounts

start_datestring date-time nullable

The start date for this media

end_datestring date-time nullable

The end date for this media

idstring nullable

The media id

group_namestring nullable

The group name

mime_typestring nullable

The MIME type for this media

file_sizeinteger

The file size in bytes

file_namestring nullable

The file name

file_urlstring nullable

The file URL

thumbnail_urlstring nullable

The thumbnail URL

uploaded_onstring date-time nullable

The date the media was uploaded

uploaded_by_idstring nullable

The user id that uploaded the media

sha_512string nullable

The SHA512 hash of the media file

widthinteger nullable

The width of the media

heightinteger nullable

The height of the media

is_approvedboolean nullable

Approval state. True = approved for playback, false = declined, null = pending review.

approved_onstring date-time nullable

Timestamp the media was approved, if applicable.

declined_onstring date-time nullable

Timestamp the media was declined, if applicable.

declined_reasonstring nullable

Reason recorded when the media was declined, if any.