Update Product by lookup key

PATCH /products/:lookupKey/:lookupValue

Use this endpoint to update product by lookup key. If multiple products with the same lookup key exist, use additional filtering depending on the lookup key to uniquely identify the product (e.g. source and language for lookup key source).

Request

Path Parameters

lookupKey stringrequired

Lookup key. Read more about product lookup keys

lookupValue stringrequired

The value of the key (id, sourceId, sku or supplierCode)

Query Parameters

source string

Optional. Used in combination with lookup key sourceId

language string

Optional. Default language of the product

application/json

Body

costPrice number

descriptions

object[]

Array [

language string

value string

]

eanCode string

manufacturer string

minimumQuantity number

names

object[]

Array [

language string

value string

]

notes

object[]

Array [

language string

value string

]

oemCode string

package string

packageDescriptions

object[]

Array [

language string

value string

]

parent

object

id number

price number

shortDescriptions

object[]

Array [

language string

value string

]

shortName string

sku string

source string

sourceId string

status string

suggestedPrice number

supplier string

supplierCode string

taxCode string

unit number

Responses

Update Product by Id - 200

Response Headers

Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string

application/json

Schema
Example (from schema)
Update Product by Id - 200

Schema

data

object

costPrice number

descriptions

object[]

Array [

language string

value string

]

eanCode string

id number

manufacturer string

minimumQuantity number

names

object[]

Array [

language string

value string

]

notes

object[]

Array [

language string

value string

]

oemCode string

package string

packageDescriptions

object[]

Array [

language string

value string

]

parent

object

id number

price number

shortDescriptions

object[]

Array [

language string

value string

]

shortName string

sku string

source string

sourceId string

status string

suggestedPrice number

supplier string

supplierCode string

taxCode string

unit number

messages string[]

total number

{
  "data": {
    "costPrice": 400.95,
    "descriptions": [
      {
        "language": "NL",
        "value": "De high-end Edge 1030 fietscomputer van Garmin zit boordevol functies voor geweldige fietsavonturen. Met deze fietscomputer weet je niet alleen waar je bent en waar je naartoe moet, je weet ook welke routes populair zijn en wat je fietsmaten doen.<br />De Garmin Edge 1030 is uitgerust met Popularity Routing, dat de beste routes vindt, gebaseerd op miljoenen afgelegde fietskilometers in Garmin Connect. Bovendien kun je snel berichten sturen naar je fietsvrienden met rider-to-rider messaging. Je kunt bovendien live je prestaties analyseren dankzij de verbeterde realtime Strava integratie en de voorgeïnstalleerde TrainingPeaks Connect IQ app. Dit geeft je net dat duwtje in de rug om je persoonlijke records (of die van je vrienden) te verbrijzelen."
      },
      {
        "language": "EN",
        "value": "The high-end Garmin Edge 1030 bike computer is packed with features for great cycling adventures. With this cycling computer you not only know where you are and where you have to go, you also know which routes are popular and what your bike sizes are doing.<br />Garmin Edge 1030 features Popularity Routing, which finds the best routes based on millions of bike miles traveled in Garmin Connect. Plus, you can quickly message your cycling friends with rider-to-rider messaging. You can also analyze your performance live thanks to the improved real-time Strava integration and the pre-installed TrainingPeaks Connect IQ app. This gives you just that little push to shatter your personal bests (or those of your friends)."
      }
    ],
    "eanCode": "0753759256289",
    "id": 40360,
    "manufacturer": "Garmin",
    "minimumQuantity": 1,
    "names": [
      {
        "language": "NL",
        "value": "Edge 1030 FietsComputer"
      },
      {
        "language": "EN",
        "value": "Edge 1030 Bike computer"
      }
    ],
    "notes": [
      {
        "language": "NL",
        "value": "Edge 1030 FietsComputer"
      },
      {
        "language": "EN",
        "value": "Edge 1030 Bike computer"
      }
    ],
    "oemCode": "NCABD70004",
    "package": "STK",
    "packageDescriptions": [
      {
        "language": "NL",
        "value": "Stuks"
      },
      {
        "language": "EN",
        "value": "Pieces"
      }
    ],
    "parent": {
      "id": 1202
    },
    "price": 599.95,
    "shortDescriptions": [
      {
        "language": "NL",
        "value": "De high-end Edge 1030 fietscomputer van Garmin zit boordevol functies voor geweldige fietsavonturen. Met deze fietscomputer weet je niet alleen waar je bent en waar je naartoe moet, je weet ook welke routes populair zijn en wat je fietsmaten doen."
      },
      {
        "language": "EN",
        "value": "The high-end Garmin Edge 1030 bike computer is packed with features for great cycling adventures. With this cycling computer you not only know where you are and where you have to go, you also know which routes are popular and what your bike sizes are doing."
      }
    ],
    "shortName": "Edge 1030 FietsComputer",
    "sku": "NCABD70004",
    "source": "TECHDATA",
    "sourceId": "NCABD70004",
    "status": "A",
    "suggestedPrice": 580,
    "supplier": "TECHDATA",
    "supplierCode": "NCABD70004",
    "taxCode": "H",
    "unit": 1
  },
  "messages": [
    "Product updated"
  ],
  "total": 1
}

{
  "data": {
    "costPrice": 400.95,
    "descriptions": [
      {
        "language": "NL",
        "value": "De high-end Edge 1030 fietscomputer van Garmin zit boordevol functies voor geweldige fietsavonturen. Met deze fietscomputer weet je niet alleen waar je bent en waar je naartoe moet, je weet ook welke routes populair zijn en wat je fietsmaten doen.<br />De Garmin Edge 1030 is uitgerust met Popularity Routing, dat de beste routes vindt, gebaseerd op miljoenen afgelegde fietskilometers in Garmin Connect. Bovendien kun je snel berichten sturen naar je fietsvrienden met rider-to-rider messaging. Je kunt bovendien live je prestaties analyseren dankzij de verbeterde realtime Strava integratie en de voorgeïnstalleerde TrainingPeaks Connect IQ app. Dit geeft je net dat duwtje in de rug om je persoonlijke records (of die van je vrienden) te verbrijzelen."
      },
      {
        "language": "EN",
        "value": "The high-end Garmin Edge 1030 bike computer is packed with features for great cycling adventures. With this cycling computer you not only know where you are and where you have to go, you also know which routes are popular and what your bike sizes are doing.<br />Garmin Edge 1030 features Popularity Routing, which finds the best routes based on millions of bike miles traveled in Garmin Connect. Plus, you can quickly message your cycling friends with rider-to-rider messaging. You can also analyze your performance live thanks to the improved real-time Strava integration and the pre-installed TrainingPeaks Connect IQ app. This gives you just that little push to shatter your personal bests (or those of your friends)."
      }
    ],
    "eanCode": "0753759256289",
    "id": 40360,
    "manufacturer": "Garmin",
    "minimumQuantity": 1,
    "names": [
      {
        "language": "NL",
        "value": "Edge 1030 FietsComputer"
      },
      {
        "language": "EN",
        "value": "Edge 1030 Bike computer"
      }
    ],
    "notes": [
      {
        "language": "NL",
        "value": "Edge 1030 FietsComputer"
      },
      {
        "language": "EN",
        "value": "Edge 1030 Bike computer"
      }
    ],
    "oemCode": "NCABD70004",
    "package": "STK",
    "packageDescriptions": [
      {
        "language": "NL",
        "value": "Stuks"
      },
      {
        "language": "EN",
        "value": "Pieces"
      }
    ],
    "parent": {
      "id": 1202
    },
    "price": 599.95,
    "shortDescriptions": [
      {
        "language": "NL",
        "value": "De high-end Edge 1030 fietscomputer van Garmin zit boordevol functies voor geweldige fietsavonturen. Met deze fietscomputer weet je niet alleen waar je bent en waar je naartoe moet, je weet ook welke routes populair zijn en wat je fietsmaten doen."
      },
      {
        "language": "EN",
        "value": "The high-end Garmin Edge 1030 bike computer is packed with features for great cycling adventures. With this cycling computer you not only know where you are and where you have to go, you also know which routes are popular and what your bike sizes are doing."
      }
    ],
    "shortName": "Edge 1030 FietsComputer",
    "sku": "NCABD70004",
    "source": "TECHDATA",
    "sourceId": "NCABD70004",
    "status": "A",
    "suggestedPrice": 580,
    "supplier": "TECHDATA",
    "supplierCode": "NCABD70004",
    "taxCode": "H",
    "unit": 1
  },
  "messages": [
    "Product updated"
  ],
  "total": 1
}

Update Product by Id - 400 (invalid schema)

Response Headers

Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string

application/json

Schema
Example (from schema)
Update Product by Id - 400 (invalid schema)

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

{
  "error": {
    "code": 10007,
    "messages": [
      "#: extraneous key [name] is not permitted"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/10007",
    "status": 400,
    "type": "SchemaValidationException"
  }
}

{
  "error": {
    "code": 10007,
    "messages": [
      "#: extraneous key [name] is not permitted"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/10007",
    "status": 400,
    "type": "SchemaValidationException"
  }
}

Update Product by Id - 404

Response Headers

Alt-Svc
string
Via
string
alt-svc
string
content-length
string
date
string
return-format
string
server
string
x-request-id
string

application/json

Schema
Example (from schema)
Update Product by Id - 404

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

{
  "error": {
    "code": 80006,
    "messages": [
      "Product with id [481189] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/80006",
    "status": 404,
    "type": "ProductNotFound"
  }
}

{
  "error": {
    "code": 80006,
    "messages": [
      "Product with id [481189] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/80006",
    "status": 404,
    "type": "ProductNotFound"
  }
}

Update Product by lookup key

/products/:lookupKey/:lookupValue

Request​

Path Parameters

Query Parameters

Body

Responses​

Request

Responses