Getting Started

Authentication v3

Concepts
System Apps
User Apps
Authentication Endpoints

Product Catalog

Product Catalog API - Overview
Developer Guide
Data Ingestion Best Practices
Attributes & Attribute Mapping
Categories
Products
- Product Catalog API
- Create
- Update
- Delete
- Get
- Update Product Attributes
- Add Variants
- Remove Variants
- Get Variants
- Assign Bundle Items
- Remove Bundle Items
- Get Products in a Bundle
- Change Category Assignment
- Publish
- Unpublish
Collections
Background Jobs
Bulk Import & Export
Published Products

Orders

Orders (3.0.0)
Developer Guide
Orders FAQ
Shopping Lists
Shipping Methods
Imports
Exports
Orders
Frauds
Notifications
Backorders Preorders
Cancellations
Allocations
Shipments
Inventory Transfers
Tracking
Invoices
Payments
Credits
Appeasements
Returns

Inventory

Inventory (3.0.0)
Inventory FAQ
Imports
Counters
Inventory
Locations
Networks

Integrations

Offers

Offers (3.0.0)
Developer Guide
Real-time Pricing Engine
Price Lists
Prices
Price Types
Price Controls
Price Methods
Priced Products
Add-ons
Promotions
Coupons
Coupon Codes
Redemptions
Product Exclusion Lists
Segments
Imports
Exports
Attributes
Webhook Events

Carts

Overview
Developer Guides
Carts
Order Draft
Items
Addresses
Payments
Fulfillment
Customer
Coupons
Validations
Cart Orchestrator

Customers

Customer Profile
Customer Address
Customer Self

Update Product Attributes

Partially update product attributes by ID

Product attributes are the objective and factual descriptions of products that shoppers see when they browse through an e-commerce platform. Attributes may be technical specifications like size, weight, etc., design specifications like color, material, etc., or basic specifications such as name, description, ID, etc. With this endpoint, you can partially update attributes of a given product. Note:
1. This endpoint is recommended over PUT /products/{id}/attributes (Update product attributes by ID) if you want to update only specific attributes without affecting the others.
2. If you don’t have product ID, use the corresponding SKU-based endpoint - PATCH /products/sku/{sku}/attributes.

PATCH

products

{id}

attributes

curl --request PATCH \
  --url https://api.fabric.inc/v3/products/{id}/attributes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": [
    {
      "op": "add",
      "path": "/attributes/-",
      "value": {
        "id": "6454e9e045276428de74c554",
        "value": "blue"
      }
    }
  ]
}'

Authorizations

Authorization

string

headerrequired

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.

x-fabric-request-id

string

Unique request ID

Path Parameters

string

required

24-character system-generated product ID.

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.

Body

application/json

Request for partial update

data

object[]

required

Response

200 - application/json

Details of Item by ID

string

Product ID

sku

string

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

type

enum<string>

Supported product types

Available options:

ITEM,

VARIANT,

BUNDLE

isActive

boolean

true: Product is active false: Product is inactive

hasDraft

boolean

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

hasLive

boolean

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

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

attributes

object[]

Attributes of product

localizedProperties

object

Localized attribute names

parentProduct

object

Parent item ID of the Variant

variants

object[]

Product variants by ID

categoryId

string

24-character system-generated category ID of product

bundleProducts

object[]

Items or variants that are part of Bundle by ID

createdAt

string

Time of product creation (UTC)

updatedAt

string

Time of last update to product (UTC)

Was this page helpful?

Update product attributes by SKU Add variants to products by ID

curl --request PATCH \
  --url https://api.fabric.inc/v3/products/{id}/attributes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "data": [
    {
      "op": "add",
      "path": "/attributes/-",
      "value": {
        "id": "6454e9e045276428de74c554",
        "value": "blue"
      }
    }
  ]
}'