Storefront

Update hero slide

PUT/api/v1/storefront/admin/hero-slides/:id

Updates a hero slide's content, ordering, or image. Admin-only.

Requires Authorization

ADMIN only

Authenticated action

Path parameters

idstringrequired

Hero slide ID.

Form fields

`title`string
`subtitle`string
`linkUrl`string
`position`number
`isActive`boolean
`image`file	Replaces the existing image.

Request

curl --request PUT \
  --url https://api.swiftgoma.com/api/v1/storefront/admin/hero-slides/:id \
  --header 'Authorization: Bearer <access_token>' \
  --form 'title=<title>' \
  --form 'subtitle=<subtitle>' \
  --form 'linkUrl=<linkUrl>' \
  --form 'position=<position>' \
  --form 'isActive=<isActive>' \
  --form 'image=@/path/to/file.jpg'

200Example response

{
  "success": true,
  "data": {
    "id": "slide_1a2b3c",
    "title": "Soldes de rentrée",
    "subtitle": "Jusqu'à -30% sur une sélection de produits",
    "imageUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/storefront/hero1.jpg",
    "linkUrl": "/products?category=electronics",
    "position": 1,
    "isActive": true,
    "createdAt": "2026-01-10T08:00:00.000Z"
  }
}