Skip to content
Navigation

Sets, swaps or clears a product's thumbnail, its first poster, if it is still the one the caller saw.

PUT
https://api.sherpo.io/merchant/v1/stores/{store}/products/{product}/poster

Authorization

  • bearer
    HTTP
    required

Path parameters

  • store
    string
    required

    The store's id.

  • product
    string
    required

    An id, or slug:<slug>.

    minLength: 1

Header parameters

  • Idempotency-Key
    optional
    string

    Repeats within 24 hours answer the first result; the same key with other arguments is a conflict.

    maxLength: 255 · minLength: 1 · pattern: ^[\x21-\x7E]+$

Request body JSON required

  • asset
    required

    The file to show, or null to show none.

    One of the following:

    • object
    • null
  • from
    required

    The first poster the caller saw, or null for none; a product showing another refuses.

    One of the following:

    • object
    • null

Returns

200

Sets, swaps or clears a product's thumbnail, its first poster, if it is still the one the caller saw.

JSON

One of the following:

  • object
  • object
JSON
  • type
    string
    required
    format: uri
  • title
    string
    required
  • status
    integer
    required
  • detail
    string
    required
  • code
    optional
    string
  • context
    optional
    object
  • reached_core
    optional
    boolean
  • core_answer
    optional
    string

Type to search…

↑↓ navigate↵ selectEsc close