Skip to main content
PUT
/
products
/
sku
/
{sku}
/
attributes
Update Product Attributes by SKU
curl --request PUT \
  --url https://api.fabric.inc/v3/products/sku/{sku}/attributes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "attributes": [
    {
      "id": "6d7329dfd5288b0011332311",
      "value": "blue"
    }
  ],
  "localizedProperties": {
    "en-US": {
      "attributes": [
        {
          "id": "W123333RRTT555y1",
          "value": "blue"
        }
      ]
    },
    "en-IN": {
      "attributes": [
        {
          "id": "W123333RRTT555AA",
          "value": "blue"
        }
      ]
    }
  }
}
'
{
  "id": "717329dfd5288b0011332317",
  "sku": "QWEFFVVV",
  "type": "ITEM",
  "isActive": true,
  "hasDraft": true,
  "hasLive": true,
  "status": "LIVE",
  "attributes": [
    {
      "id": "7b17329dfd5288b0011332314",
      "name": "Color",
      "type": "string",
      "isDeleted": false,
      "value": "blue",
      "isInherited": true
    }
  ],
  "localizedProperties": {
    "en-US": {
      "attributes": [
        {
          "id": "8b7329dfd5288b0011332317",
          "name": "Color",
          "type": "string",
          "isDeleted": false,
          "value": "blue",
          "isInherited": true
        }
      ]
    },
    "en-IN": {
      "attributes": [
        {
          "id": "9e7329dfd5288b0011332388",
          "name": "Colour",
          "type": "string",
          "isDeleted": false,
          "value": "blue",
          "isInherited": true
        }
      ]
    }
  },
  "variants": [
    {
      "id": "5b7329dfd5288b0011332322",
      "sku": "AA334V2"
    }
  ],
  "categoryId": "7b7329dfd5288b0011332389",
  "createdAt": "2021-09-14T22:10:30.618Z",
  "updatedAt": "2021-09-14T22:10:30.618Z"
}

Authorizations

​
Authorization
string
header
required

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

Headers

​
x-fabric-tenant-id
string

A header used by fabric to identify the tenant making the request. You must include tenant id in the authentication header for an API request to access any of fabric’s endpoints. You can retrieve the tenant id , which is also called account id, from Copilot. This header is required.

Example:

"517fa9dfd42d8b00g1o3k312"

​
x-fabric-request-id
string

Unique request ID

Example:

"263e731c-45c8-11ed-b878-0242ac120002"

Path Parameters

​
sku
string
required

Product SKU

Query Parameters

​
statuses
string
default:DRAFT,LIVE

Comma-separated statuses indicating the preferred order of the product versions considered for this operation (endpoint action). For example,
1. When the status is DRAFT, this operations will only apply to the Draft version of product, if it exists
2. When the status is LIVE, this operation will only apply to the Live version of the product, if it exists
3 When the status is LIVE,DRAFT, this operation will prioritize Live version first, if it exists. Otherwise, the Draft version is considered.
4 When the status is DRAFT,LIVE this operation will prioritize the Draft version first, if it exists. Otherwise, the Live version is considered.

Example:

"DRAFT"

Body

application/json

Request to update product attributes.

​
attributes
object[]

Array of product attributes

​
localizedProperties
object
Example:
{
  "en-US": {
    "attributes": [
      { "id": "W123333RRTT555y1", "value": "blue" }
    ]
  },
  "en-IN": {
    "attributes": [
      { "id": "W123333RRTT555AA", "value": "blue" }
    ]
  }
}

Response

OK

Details of Item by SKU

​
id
string

Product ID

Example:

"AASSBCC12334FCD12334V"

​
sku
string

Unique product ID that maps to fabric's standard attribute called SKU.
Note: sku shouldn't include ; or =

Example:

"XP-123345"

​
type
enum<string>

Supported product types

Available options:
ITEM,
VARIANT,
BUNDLE
Example:

"ITEM"

​
isActive
boolean

true: Product is active
false: Product is inactive

Example:

true

​
hasDraft
boolean

true: Product has a Draft version
false: Product doesn't have a Draft version

Example:

true

​
hasLive
boolean

true: Product has a Live version
false: Product doesn't have a Live version

Example:

true

​
status
enum<string>

Represents the current status of product. This value takes precedence over isActive if both are sent in the request.

Available options:
DRAFT,
LIVE
Example:

"LIVE"

​
attributes
object[]

Attributes assigned to product

​
localizedProperties
object

Localized attribute names

Example:
{
  "en-US": {
    "attributes": [
      {
        "id": "4e7329dfd5288b0011332366",
        "name": "Color",
        "type": "string",
        "isDeleted": false,
        "value": "blue",
        "isInherited": true
      }
    ]
  }
}
​
parentProduct
object

Parent item SKU of the Variant

​
variants
object[]

Variants with ID and SKU

​
bundleProducts
object[]

Bundles with ID and SKU

​
categoryId
string

24-character system-generated category ID of product

Example:

"6h7329dfd5288b001133231d"

​
createdAt
string

Time of product creation (UTC)

Example:

"2021-09-14T22:10:30.618Z"

​
updatedAt
string

Time of last update to product (UTC)

Example:

"2021-09-14T22:10:30.618Z"