PUT /api/vendor-widget/1 HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "title": "Summer Sale",
  "name": "Summer Sale",
  "widgetTitle": "Featured Products",
  "widgetSlugName": "featured-products",
  "link": "/offers/summer",
  "sortOrder": 1,
  "status": 1,
  "image": "<IMAGE_REFERENCE>"
}

{
  "status": 1,
  "message": "Resource updated successfully",
  "data": {
    "widgetId": 1,
    "widgetTitle": "Featured Products",
    "widgetSlugName": "featured-products",
    "status": 1
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Banners and widgets

Update Widget

Put /api/vendor-widget/:id

Authentication: Vendor bearer token required for protected operations; verify exact permission decorator in controller.

Feature area: Widgets

Implementation source: src/api/vendor/controllers/BannerController.ts

Request example provenance: Illustrative body using common Banner/Widget fields; confirm the route-specific request DTO.

Response example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.

Example status: Illustrative. The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.

PUT

api

vendor-widget

{id}

PUT /api/vendor-widget/1 HTTP/1.1
Host: <API_HOST>
Accept: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Type: application/json

{
  "title": "Summer Sale",
  "name": "Summer Sale",
  "widgetTitle": "Featured Products",
  "widgetSlugName": "featured-products",
  "link": "/offers/summer",
  "sortOrder": 1,
  "status": 1,
  "image": "<IMAGE_REFERENCE>"
}

{
  "status": 1,
  "message": "Resource updated successfully",
  "data": {
    "widgetId": 1,
    "widgetTitle": "Featured Products",
    "widgetSlugName": "featured-products",
    "status": 1
  }
}

{
  "status": 0,
  "message": "Invalid request or resource."
}

Authorizations

Authorization

string

header

required

Paste the JWT access token returned by the corresponding login endpoint.

Path Parameters

string

required

Value for id.

Body

application/json

Sample request body. Illustrative body using common Banner/Widget fields; confirm the route-specific request DTO. Treat this as an illustrative example, not a complete DTO contract.

title

string

name

string

link

string

sortOrder

integer

status

integer

image

string

Response

Successful response. Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema. Example is illustrative and does not guarantee a stable response contract.

status

integer

message

string

data

object

Show child attributes

Store API

Vendor API

Update Widget

Authorizations

Path Parameters

Body

Response