Update Hero Banners

The Update Hero Banners API updates existing hero banners (web and mobile) for a given banner ID. It requires valid data and a valid banner ID.

Endpoint

Path Parameter

Name	Type	Required	Description
id	string	Yes	The ID of the banner to update (MongoDB ObjectId).

Request Body

Name	Type	Required	Description
webBanners	array	Yes	List of web hero banner image URLs (strings).
mobileBanners	array	Yes	List of mobile hero banner image URLs (strings).
vendorId	string	Yes	The vendor's unique MongoDB ObjectId.

Response

Status Code	Description
200	Hero banner updated successfully.
400	Validation error or bad request.
403	Forbidden - user does not have permission to perform this action.
404	Not Found - banner with provided ID not found.
500	Internal Server Error.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Example

{
    "webBanners":"https://uIqCNVNd.boqhsfrR6lLUwUerb8LhbTEh41ur4qVVzBUzRk4z3bsA",
    "mobileBanners": "https://uIqCNVNd.boqhsfrR6lLUwUerb8LhbTEh41ur4qVVzBUzRk4z3bsA",
    "vendorId": "647587fc52f887dacdeb76b3"
}

Responses

🟢200Success

application/json

Body

Example

{
    "statusCode": 200,
    "status": true,
    "message": "Hero banner updated successfully",
    "response": {
        "banner": {
            "_id": "6821d82a7ff94ab7ea0dbf2c",
            "heroBanners": "https://uIqCNVNd.boqhsfrR6lLUwUerb8LhbTEh41ur4qVVzBUzRk4z3bsA",
            "createdAt": "2025-05-12T11:14:50.667Z",
            "updatedAt": "2025-07-21T04:42:23.001Z",
            "__v": 0,
            "mobileHeroBanners": "https://uIqCNVNd.boqhsfrR6lLUwUerb8LhbTEh41ur4qVVzBUzRk4z3bsA",
            "vendorId": "b5d48bba43c3b1cfbac50230"
        }
    }
}

🔴500Server Error

🟠404Not found response

🟠403Forbidden Response

🟠401Unauthorized Response

🟠400Bad Request Response

Update hero banners

Update Hero Banners#

Request

Responses

Update Hero Banners