Sign in

v1

latestOpenAPI 3.0.42026-08-06124112344.5 KB
Media

Uploads new media asset.

POST body should contain raw binary media file

post/media/{group_id}/{file_name}

Path parameters

group_idstring required
file_namestring required

Query parameters

sharedboolean

Optional media sharing

start_datestring date-time

Optional start date

end_datestring date-time

Optional end date

advertiser_idinteger

Optional advertiser user Id

namestring

Optional media name. Overrides the uploaded name

descriptionstring

Optional media tags

Response

Created

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.