v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB

Media

Import a file from a URL.

post/media/import

Query parameters

urlstring

URL of the file to import

group_idstring

Media group Id

Response

Returns the newly 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.