Skip to main content
POST
/
v1
/
products
/
bulk-update
curl --location --request POST 'https://api.stateset.com/v1/products/bulk-update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "updates": [
        {
            "id": "prod_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
            "price": {
                "amount": 11999
            },
            "tags": ["electronics", "audio", "sale", "clearance"]
        },
        {
            "id": "prod_abc123def456",
            "price": {
                "amount": 6999
            },
            "inventory": {
                "low_stock_threshold": 25
            }
        },
        {
            "id": "prod_xyz789ghi012",
            "status": "archived"
        }
    ]
}'

{
  "updated": [
    {
      "id": "prod_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
      "name": "Wireless Bluetooth Headphones",
      "sku": "WBH-001",
      "updated_at": "2024-01-15T17:30:00Z"
    },
    {
      "id": "prod_abc123def456",
      "name": "Sport Wireless Earbuds",
      "sku": "SWE-001",
      "updated_at": "2024-01-15T17:30:00Z"
    }
  ],
  "errors": [
    {
      "product_id": "prod_xyz789ghi012",
      "error": "Product not found"
    }
  ],
  "summary": {
    "total": 3,
    "successful": 2,
    "failed": 1
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.stateset.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows updating up to 100 products in a single request. Use this for bulk price changes, inventory updates, or status changes.

​
Request Body

​
updates
array
required
Array of product updates (max 100 items)
​
validate_only
boolean
If true, validates the updates without applying them (default: false)

​
Response

​
updated
array
Successfully updated products
​
errors
array
Products that failed to update with error details
​
summary
object
Summary of the bulk operation
curl --location --request POST 'https://api.stateset.com/v1/products/bulk-update' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "updates": [
        {
            "id": "prod_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
            "price": {
                "amount": 11999
            },
            "tags": ["electronics", "audio", "sale", "clearance"]
        },
        {
            "id": "prod_abc123def456",
            "price": {
                "amount": 6999
            },
            "inventory": {
                "low_stock_threshold": 25
            }
        },
        {
            "id": "prod_xyz789ghi012",
            "status": "archived"
        }
    ]
}'

{
  "updated": [
    {
      "id": "prod_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
      "name": "Wireless Bluetooth Headphones",
      "sku": "WBH-001",
      "updated_at": "2024-01-15T17:30:00Z"
    },
    {
      "id": "prod_abc123def456",
      "name": "Sport Wireless Earbuds",
      "sku": "SWE-001",
      "updated_at": "2024-01-15T17:30:00Z"
    }
  ],
  "errors": [
    {
      "product_id": "prod_xyz789ghi012",
      "error": "Product not found"
    }
  ],
  "summary": {
    "total": 3,
    "successful": 2,
    "failed": 1
  }
}