TOtonewow
banners

Update an existing banner

Update an existing banner with optional new image. Any authenticated user can update, but changes may require admin approval.

put/banner/{id}

Request

  • Base URL
    https://api.tonewow.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.tonewow.com/banner/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required
Example:1

Banner ID

Request body multipart/form-data

bannerImageUrlstring binary

New banner image file (optional)

bannerUrlstring

Landing page URL (optional)

startDatestring date-time

Start date (ISO 8601) (optional)

endDatestring date-time

End date (ISO 8601) (optional)

status'ACTIVE' | 'DEACTIVE'

Banner status (optional)

languageType'BM' | 'EN'

Language type (optional)

Example request

{
  "bannerUrl": "https://example.com/new-landing",
  "startDate": "2024-01-01T00:00:00.000Z",
  "endDate": "2024-12-31T23:59:59.000Z",
  "status": "ACTIVE",
  "languageType": "EN"
}

Response

Banner updated successfully

idnumber required

Banner ID

bannerImageUrlstring required

Banner image URL

bannerUrlstring

Landing page URL

status'ACTIVE' | 'DEACTIVE' | 'PENDING_APPROVE' required

Banner status

order_idstring required

Display order

start_datestring date-time

Start date

end_datestring date-time

End date

languageType'BM' | 'EN' required

Language type

Example response

{
  "id": 1,
  "bannerImageUrl": "https://example.com/banner.jpg",
  "bannerUrl": "https://example.com/landing",
  "status": "ACTIVE",
  "order_id": "1",
  "start_date": "2024-01-01T00:00:00.000Z",
  "end_date": "2024-12-31T23:59:59.000Z",
  "languageType": "EN"
}

Changes

No recorded changes to this operation across all 6 revisions of this API.