Upload a video to an ad

POST /advertising/v1.0/ads/{adId}/videos/

Endpoint for uploading videos. The request timeout is 10 minutes. The "Content-Type" header must be "multipart/form-data". The "Content-Length" header must contain the file size in bytes. Maximum size is 1024 MB. Accepted formats are: 4xm, IFF, ISS, MTV, RoQ, aac, ac3, aea, aiff, alaw, alsa, amr, anm, apc, ape, asf, ass, au, avi, avs, bethsoftvid, bfi, bink, c93, caf, cavsvideo, cdg, daud, dirac, dnxhd, dsicin, dts, dv, dv1394, dxa, ea, ea_cdata, eac3, f32be, f32le, f64be, f64le, ffm, film_cpk, filmstrip, flac, flic, flv, gsm, gxf, h261, h263, h264, idcin, image2, image2pipe, ingenient, ipmovie, iv8, lmlm4, m4v, matroska, mjpeg, mlp, mm, mmf, mov, mp4, m4a, 3gp, 3g2, mj2, mp3, mpc, mpc8, mpeg, mpegts, mpegtsraw, mpegvideo, msnwctcp, mulaw, mvi, mxf, nc, nsv, nut, nuv, ogg, oma, oss, psxstr, pva, qcp, r3d, rawvideo, rl2, rm, rpl, rtsp, s16be, s16le, s24be, s24le, s32be, s32le, s8, sdp, shn, siff, smk, sol, sox, swf, thp, tiertexseq, tmv, truehd, tta, txd, u16be, u16le, u24be, u24le, u32be, u32le, u8, vc1, vc1test, video4linux, video4linux2, vmd, voc, vqf, w64, wav, wc3movie, wsaud, wsvqa, wv, xa, yop, yuv4mpegpipe.

Path parameters

  • adId string Required

    Id of an advertisement. It is either id that was provided in the response of the insert endpoint or it can be thirdPartyId, if it has been provided in the request body of the advertisement insert endpoint.

Query parameters

  • thirdPartyId string

    Optional custom id that can later be used instead of normal id in insert, update, delete etc. endpoints

  • order number(float)

    When displayed publicly, videos will be sorted by the "order" value in ascending order

multipart/form-data

Body

Accepted formats are: 4xm, IFF, ISS, MTV, RoQ, aac, ac3, aea, aiff, alaw, alsa, amr, anm, apc, ape, asf, ass, au, avi, avs, bethsoftvid, bfi, bink, c93, caf, cavsvideo, cdg, daud, dirac, dnxhd, dsicin, dts, dv, dv1394, dxa, ea, ea_cdata, eac3, f32be, f32le, f64be, f64le, ffm, film_cpk, filmstrip, flac, flic, flv, gsm, gxf, h261, h263, h264, idcin, image2, image2pipe, ingenient, ipmovie, iv8, lmlm4, m4v, matroska, mjpeg, mlp, mm, mmf, mov, mp4, m4a, 3gp, 3g2, mj2, mp3, mpc, mpc8, mpeg, mpegts, mpegtsraw, mpegvideo, msnwctcp, mulaw, mvi, mxf, nc, nsv, nut, nuv, ogg, oma, oss, psxstr, pva, qcp, r3d, rawvideo, rl2, rm, rpl, rtsp, s16be, s16le, s24be, s24le, s32be, s32le, s8, sdp, shn, siff, smk, sol, sox, swf, thp, tiertexseq, tmv, truehd, tta, txd, u16be, u16le, u24be, u24le, u32be, u32le, u8, vc1, vc1test, video4linux, video4linux2, vmd, voc, vqf, w64, wav, wc3movie, wsaud, wsvqa, wv, xa, yop, yuv4mpegpipe.

Responses

POST /advertising/v1.0/ads/{adId}/videos/ 
curl \
 -X POST http://apis.public-staging.reas.cz/advertising/v1.0/ads/63d9007e66fc41b2cd1057c6/videos/ \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: multipart/form-data" \
 -F "file=@file"
Response examples (200) 
{
  "success": true,
  "data": {
    "id": "string",
    "url": "string",
    "order": 42.0,
    "createdAt": "2024-05-04T09:42:00+00:00"
  }
}