Advertising service

Upload an image to an ad

POST /advertising/v1.0/ads/{adId}/images/
Token

Endpoint for uploading images that will be attached to advertisement. The "Content-Type" header must be "multipart/form-data". The "Content-Length" header must contain the file size in bytes. Allowed formats are jpeg, gif and png.

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, images will be sorted by the "order" value in ascending order

multipart/form-data

Body

Allowed formats are jpeg, gif and png.

  • image string(binary)

Responses

  • 200 application/json

    Image successfully uploaded

    Hide response attributes Show response attributes object
    • success boolean Required
    • data object Required

      Additional properties are NOT allowed.

      Hide data attributes Show data attributes object
      • id string Required
      • url string Required
      • order number(float)
      • createdAt string(date-time) Required
      • thirdPartyId string
  • 404

    Related advertisement does not exist.

POST /advertising/v1.0/ads/{adId}/images/ 
curl \
 --request POST 'http://apis.reas.cz/advertising/v1.0/ads/63d9007e66fc41b2cd1057c6/images/' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: multipart/form-data" \
 --form "image=@file"
Response examples (200) 
{
  "success": true,
  "data": {
    "id": "string",
    "url": "string",
    "order": 42.0,
    "createdAt": "2025-05-04T09:42:00Z",
    "thirdPartyId": "string"
  }
}