Upload an image to an ad

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

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
  
  Hide data attributes Show data attributes object
  
  id string Required
  
  url string Required
  
  order number(float)
  
  createdAt string(date-time) Required
  
  thirdPartyId string
  
  Additional properties are NOT allowed
- Additional properties are NOT allowed
404

Related advertisement does not exist.

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

curl \
 -X POST http://apis.reas.cz/advertising/v1.0/ads/63d9007e66fc41b2cd1057c6/images/ \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Content-Type: multipart/form-data" \
 -F "image=@file"

Request example

{
  "image": "@file"
}

Response examples (200)

{
  "success": true,
  "data": {
    "id": "string",
    "url": "string",
    "order": 42.0,
    "createdAt": "2023-05-04T09:42:00+00:00",
    "thirdPartyId": "string"
  }
}