Skip to main content
PUT
Edit Product

Overview

Update an existing product’s details. All fields are optional - only include fields you want to change. The same validation rules from Create Product apply.
Rate Limit: 20 requests per minute

Endpoint

Path Parameters

string
required
UUID of the product to edit

Authentication

string
required
Your TribeMade API key (format: tb-xxxx-xxx-xxxx)

Request Body

All fields from Create Product can be updated. Include only the fields you want to change.
string
Product name (3-30 characters)
number
Original/MRP price in INR (must be > 0)
number
Sale price in INR (must be >= 0)
string
Detailed product description (0-500 characters)
string
Short description (0-50 characters)
integer
Available quantity (must be >= 0)
number
Shipping cost in INR (must be >= 0)
string
Primary product image URL or base64 (max 5MB)
array
Additional images (max 10, each max 5MB)
array
Product variations (max 20 items)
array
Available sizes (max 20 items)
array
Available colors (max 20 items)
array
Product categories (max 20, must exist in store)
boolean
Mark product as on sale
boolean
Product visibility to customers
array
Custom questions (max 5)
string
Private seller notes (0-500 characters)
object
Custom key-value pairs

Response

string
Success message: “Product updated successfully”

Examples

Update Price and Stock

Success Response

Update Multiple Fields

Update description, add internal notes, and update stock:

Disable Product

Temporarily hide a product from customers:

Update Images and Categories

Categories must be created in your store first. Use exact category names (case-sensitive).

Error Responses

400 Bad Request - No Fields to Update

Cause: The request body is empty or contains no valid fields. Fix: Include at least one field to update.

400 Bad Request - Validation Errors

All validation errors from Create Product apply:
  • Invalid name length
  • Invalid price (must be > 0)
  • Invalid description length
  • Invalid stock (must be >= 0)
  • Too many images/variations/sizes/colors/categories
  • Invalid categories
  • Image too large
  • Invalid custom question types
See Create Product Errors for details.

404 Not Found

Causes:
  • Product ID doesn’t exist
  • Product belongs to a different store
  • Product was deleted
Fix: Verify the product ID and ensure it belongs to your store.

401 Unauthorized

or

429 Too Many Requests

Common Use Cases

Inventory Sync

Keep stock levels synchronized with your warehouse system:

Flash Sale

Run a flash sale by updating prices:

Bulk Status Update

Activate or deactivate multiple products:

Best Practices

Only include fields that need to be updated. Don’t send the entire product object:✅ Good:
❌ Bad:
Set up automated inventory sync to keep stock levels accurate:
  • Run sync every 15-30 minutes for high-traffic stores
  • Use webhooks to get notified of orders and update stock accordingly
  • Log sync operations for debugging
For sales and promotions:
  • Update prices at specific times (e.g., midnight for daily deals)
  • Store original prices before sales to restore later
  • Use internal_note to track sale end dates
For bulk updates:
  • Process in batches of 15-18 products per minute
  • Add 3-4 second delays between requests
  • Implement retry logic for failed updates
  • Log all operations for tracking
Instead of deleting products, use is_active: false to temporarily hide them:
  • Preserves product data and history
  • Can be reactivated anytime
  • Maintains order references
  • Useful for seasonal products

Next Steps

Create Product

Learn how to create new products

Delete Product

Remove products from your store

Order APIs

Manage orders programmatically

Rate Limits

Understand API rate limits