Update Category by lookup key

PATCH 
/categories/:lookupKey/:lookupValue

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

Request

Path Parameters

lookupKey stringrequired

Lookup key. Read more about category lookup keys

lookupValue stringrequired

The value of the key (id or sourceId)

Query Parameters

source string

Optional. Used in combination with lookup key sourceId

language string

Optional. Default language of the category

application/json

Body

descriptions

object[]

Array [

language string

value string

]

names

object[]

Array [

language string

value string

]

parent

object

id number

shortDescriptions

object[]

Array [

language string

value string

]

source string
sourceId string

Responses

200

Update Category 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

Schema

data

object

descriptions

object[]

Array [

language string

value string

]

id number

names

object[]

Array [

language string

value string

]

parent

object

id number

shortDescriptions

object[]

Array [

language string

value string

]

source string

sourceId string
messages string[]
total number

Example (from schema)

{
  "data": {
    "descriptions": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "id": 1771,
    "names": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "parent": {
      "id": 1320
    },
    "shortDescriptions": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "source": "REST-API",
    "sourceId": "020000"
  },
  "messages": [
    "Category updated"
  ],
  "total": 1
}

Update Category by Id - 200

{
  "data": {
    "descriptions": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "id": 1771,
    "names": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "parent": {
      "id": 1320
    },
    "shortDescriptions": [
      {
        "language": "NL",
        "value": "Fiets"
      },
      {
        "language": "EN",
        "value": "Bike"
      }
    ],
    "source": "REST-API",
    "sourceId": "020000"
  },
  "messages": [
    "Category updated"
  ],
  "total": 1
}

404

Update Category by source 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

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

{
  "error": {
    "code": 30006,
    "messages": [
      "Category with sourceId [17712] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/30006",
    "status": 404,
    "type": "CategoryNotFound"
  }
}

Update Category by source id - 404

{
  "error": {
    "code": 30006,
    "messages": [
      "Category with sourceId [17712] not found"
    ],
    "moreInfo": "https://www.propel.us/docs/errors/30006",
    "status": 404,
    "type": "CategoryNotFound"
  }
}

Loading...