Bulk Categories by sourceId

POST 
/categories/bulk/sourceId

The bulk endpoints offer an efficient way of importing/updating large amounts of categories with just a single API call. When using the bulk sourceId endpoint, the categories are identified by sourceId, source and language. If a category doesn't already exist, it will be created. If it does exist, the category will be updated.

Category Bulk endpoints support bulk change of category attributes for multiple categories as well. To learn more about Attributes, go here.

A single category's attributes can be modified as explained in Bulk resource attribute values by resource lookup key, but if it's needed to modify attributes for multiple categories, this endpoint should be used.

Fields

Name	Required
categories (array of category objects)	yes
sourceId	yes
source	yes
language	yes
names	yes
descriptions	no
shortDescriptions	no
attributes Read more about attributes	no
parent	yes

For more details on attributes field, read this.

Directives

Name	Description	Fields
skipIfNotEmpty	On update, skip updating fields of an existing category that are not empty	array of field names e.g. names, descriptions, etc.
skipMoveOnUpdate	On update, skip moving an existing category in the parent category provided	empty array
mergeTranslationsOnUpdate	On update, delete all translation for a category that are not provided in the payload	empty array

What are directives?

Request

application/json

Body

categories

object[]

Array [

descriptions

object[]

Array [

language string

value string

]

language string

name

object[]

Array [

language string

value string

]

names

object[]

Array [

language string

value string

]

parent

object

sourceId string

shortDescriptions

object[]

Array [

language string

value string

]

source string

sourceId string

]

directives

object[]

Array [

fields string[]

operation string

]

Responses

200

Bulk Categories by sourceId - 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[]

Array [

action string

id number

key string

lookupKey string

success boolean

]

messages string[]
total number

Example (from schema)

{
  "data": [
    {
      "action": "create",
      "id": 1779,
      "key": "011000",
      "lookupKey": "sourceId",
      "success": true
    },
    {
      "action": "update",
      "id": 1775,
      "key": "020000",
      "lookupKey": "sourceId",
      "success": true
    },
    {
      "action": "update",
      "id": 1777,
      "key": "020100",
      "lookupKey": "sourceId",
      "success": true
    }
  ],
  "messages": [
    "Completed"
  ],
  "total": 3
}

Bulk Categories by sourceId - 200

{
  "data": [
    {
      "action": "create",
      "id": 1779,
      "key": "011000",
      "lookupKey": "sourceId",
      "success": true
    },
    {
      "action": "update",
      "id": 1775,
      "key": "020000",
      "lookupKey": "sourceId",
      "success": true
    },
    {
      "action": "update",
      "id": 1777,
      "key": "020100",
      "lookupKey": "sourceId",
      "success": true
    }
  ],
  "messages": [
    "Completed"
  ],
  "total": 3
}

400

Bulk Categories by sourceId - 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

Schema

error

object

code number

messages string[]

moreInfo string

status number

type string

Example (from schema)

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

Bulk Categories by sourceId - 400 (Invalid schema)

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

Loading...