Advertising service

Update an image of an ad

PATCH /advertising/v1.0/ads/{adId}/images/{imageId}
Token

Endpoint for updating images by provided id.

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.

  • imageId string Required

    Id of an image. 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 image insert endpoint.

application/json

Body

  • order number(float)

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

Responses

  • 200 application/json

    Image successfully updated.

    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 or the image does not exist.

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