Skip to main content
POST
/
api-product
/
v1
/
product
/
bulk
/
update
Update items and bundles
curl --request POST \
  --url https://live.copilot.fabric.inc/api-product/v1/product/bulk/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-site-context: <x-site-context>' \
  --data '{
  "skus": [
    "sku12",
    "sku13"
  ],
  "type": "ITEM",
  "action": "UPDATE",
  "parentSku": "sku234",
  "attributeValues": [
    {
      "name": "Mobile",
      "value": "AMD X570 mobo"
    }
  ],
  "inheritedAttributes": [
    {
      "name": "color",
      "action": "SET"
    }
  ]
}'
{
  "success": [
    {
      "sku": "sku1",
      "itemId": "611686da50fb7e0c5df78c2e",
      "itemIdSeq": 12,
      "message": "SKU created successfully.",
      "errorAttributes": [
        {
          "name": "Inactive",
          "message": "Attribute value is invalid."
        }
      ],
      "errorBundles": [
        {
          "name": "<string>",
          "message": "<string>"
        }
      ]
    }
  ],
  "failed": [
    {
      "sku": "sku1",
      "message": "Failed because of validation"
    }
  ],
  "itemIds": [
    "611686da50fb7e0c5df78c2e",
    "711686da50fb7e0c5df78c22"
  ]
}

Authorizations

​
Authorization
string
header
required

S2S access token (JWT) from fabric Identity service (during Login)

Headers

​
x-site-context
string
required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Example:

"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"

Body

application/json
​
skus
string[]

Stock Keeping Units (SKUs)

Maximum length: 50
Example:
["sku12", "sku13"]
​
type
string

Item type - Bundle or Item

Example:

"ITEM"

​
action
string

Action type

Example:

"UPDATE"

​
parentSku
string | null

“Stock Keeping Unit (SKU) of the parent item. <br /> Set the value as detach or null to disassociate the item from parent item.”

Example:

"sku234"

​
attributeValues
object[]
  • Option 1
  • Option 2
​
inheritedAttributes
object[]

Category item attributes to inherit from parent item to children items

Response

OK

​
success
object[]
​
failed
object[]
​
itemIds
string[]

Item IDs

Example:
[
  "611686da50fb7e0c5df78c2e",
  "711686da50fb7e0c5df78c22"
]
⌘I