Edit Product

curl --request PUT \
  --url https://api.example.com/api/products/{product_id}/edit \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "price": 123,
  "current_price": 123,
  "description": "<string>",
  "short_description": "<string>",
  "stock": 123,
  "shipping_cost": 123,
  "primary_image": "<string>",
  "images": [
    {}
  ],
  "variations": [
    {}
  ],
  "size": [
    {}
  ],
  "colors": [
    {}
  ],
  "categories": [
    {}
  ],
  "is_sale": true,
  "is_active": true,
  "custom_questions": [
    {}
  ],
  "internal_note": "<string>",
  "metadata": {}
}
'

{
  "message": "<string>"
}

PUT

api

products

{product_id}

edit

Edit Product

curl --request PUT \
  --url https://api.example.com/api/products/{product_id}/edit \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "<string>",
  "price": 123,
  "current_price": 123,
  "description": "<string>",
  "short_description": "<string>",
  "stock": 123,
  "shipping_cost": 123,
  "primary_image": "<string>",
  "images": [
    {}
  ],
  "variations": [
    {}
  ],
  "size": [
    {}
  ],
  "colors": [
    {}
  ],
  "categories": [
    {}
  ],
  "is_sale": true,
  "is_active": true,
  "custom_questions": [
    {}
  ],
  "internal_note": "<string>",
  "metadata": {}
}
'

{
  "message": "<string>"
}

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

PUT https://api.tribemade.in/api/products/{product_id}/edit

Path Parameters

product_id

string

required

UUID of the product to edit

Authentication

X-API-Key

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.

name

string

Product name (3-30 characters)

price

number

Original/MRP price in INR (must be > 0)

current_price

number

Sale price in INR (must be >= 0)

description

string

Detailed product description (0-500 characters)

short_description

string

Short description (0-50 characters)

stock

integer

Available quantity (must be >= 0)

shipping_cost

number

Shipping cost in INR (must be >= 0)

primary_image

string

Primary product image URL or base64 (max 5MB)

images

array

Additional images (max 10, each max 5MB)

variations

array

Product variations (max 20 items)

size

array

Available sizes (max 20 items)

colors

array

Available colors (max 20 items)

Response

message

string

Success message: “Product updated successfully”

Examples

Update Price and Stock

curl -X PUT https://api.tribemade.in/api/products/660e8400-e29b-41d4-a716-446655440123/edit \
  -H "X-API-Key: tb-a1b2-c3d-e4f5" \
  -H "Content-Type: application/json" \
  -d '{
    "current_price": 799,
    "stock": 200,
    "is_sale": true
  }'

Success Response

{
  "message": "Product updated successfully"
}

Update Multiple Fields

Update description, add internal notes, and update stock:

{
  "description": "Updated high-quality 100% cotton t-shirt with improved fabric",
  "stock": 150,
  "internal_note": "Supplier: ABC Corp, Cost: ₹550 (increased), Reorder at 20 units",
  "metadata": {
    "material": "100% Organic Cotton",
    "care": "Machine wash cold, tumble dry low"
  }
}

Disable Product

Temporarily hide a product from customers:

curl -X PUT https://api.tribemade.in/api/products/660e8400-e29b-41d4-a716-446655440123/edit \
  -H "X-API-Key: tb-a1b2-c3d-e4f5" \
  -H "Content-Type: application/json" \
  -d '{
    "is_active": false,
    "internal_note": "Out of stock from supplier. Expected restock: Dec 15"
  }'

Update Images and Categories

{
  "primary_image": "https://cdn.example.com/new-primary-image.jpg",
  "images": [
    "https://cdn.example.com/image-1.jpg",
    "https://cdn.example.com/image-2.jpg",
    "https://cdn.example.com/image-3.jpg"
  ],
  "categories": ["Fashion", "Men's Wear", "New Arrivals"]
}

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

Error Responses

400 Bad Request - No Fields to Update

{
  "error": "No valid 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

{
  "error": "Product not found or does not belong to this store"
}

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

{
  "error": "Invalid API key"
}

{
  "error": "Missing API key"
}

429 Too Many Requests

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

Common Use Cases

Inventory Sync

Keep stock levels synchronized with your warehouse system:

import requests

def sync_inventory(products_to_update):
    """
    Sync inventory from warehouse system to TribeMade
    
    products_to_update: [{"id": "product_id", "stock": 50}, ...]
    """
    url_base = "https://api.tribemade.in/api/products"
    headers = {
        "X-API-Key": "tb-a1b2-c3d-e4f5",
        "Content-Type": "application/json"
    }
    
    for product in products_to_update:
        url = f"{url_base}/{product['id']}/edit"
        data = {"stock": product['stock']}
        
        try:
            response = requests.put(url, headers=headers, json=data)
            if response.status_code == 200:
                print(f"✓ Updated {product['id']}: stock = {product['stock']}")
            else:
                print(f"✗ Failed {product['id']}: {response.json()['error']}")
        except Exception as e:
            print(f"✗ Error {product['id']}: {str(e)}")

# Example usage
products_to_update = [
    {"id": "660e8400-e29b-41d4-a716-446655440123", "stock": 45},
    {"id": "770e8400-e29b-41d4-a716-446655440124", "stock": 32},
    {"id": "880e8400-e29b-41d4-a716-446655440125", "stock": 78}
]

sync_inventory(products_to_update)

Flash Sale

Run a flash sale by updating prices:

import requests
import time

def start_flash_sale(product_ids, discount_percent):
    """
    Apply discount to multiple products for a flash sale
    """
    url_base = "https://api.tribemade.in/api/products"
    headers = {
        "X-API-Key": "tb-a1b2-c3d-e4f5",
        "Content-Type": "application/json"
    }
    
    for product_id in product_ids:
        url = f"{url_base}/{product_id}/edit"
        
        # First, get current price (assume you have it stored)
        # For demo, we'll use a fixed price
        original_price = 1000
        sale_price = original_price * (1 - discount_percent / 100)
        
        data = {
            "current_price": sale_price,
            "is_sale": True,
            "internal_note": f"Flash sale: {discount_percent}% off until end of day"
        }
        
        response = requests.put(url, headers=headers, json=data)
        print(f"Applied {discount_percent}% discount to {product_id}")
        
        # Respect rate limits
        time.sleep(3)  # ~20 requests per minute

# Start 30% off flash sale
product_ids = ["660e8400-...", "770e8400-...", "880e8400-..."]
start_flash_sale(product_ids, discount_percent=30)

Bulk Status Update

Activate or deactivate multiple products:

import requests
import time

def bulk_update_status(product_ids, is_active):
    """
    Activate or deactivate multiple products
    """
    url_base = "https://api.tribemade.in/api/products"
    headers = {
        "X-API-Key": "tb-a1b2-c3d-e4f5",
        "Content-Type": "application/json"
    }
    
    status_text = "activated" if is_active else "deactivated"
    
    for product_id in product_ids:
        url = f"{url_base}/{product_id}/edit"
        data = {"is_active": is_active}
        
        try:
            response = requests.put(url, headers=headers, json=data)
            if response.status_code == 200:
                print(f"✓ Product {product_id} {status_text}")
            else:
                print(f"✗ Failed to update {product_id}")
        except Exception as e:
            print(f"✗ Error: {str(e)}")
        
        time.sleep(3)

# Deactivate out-of-season products
winter_products = ["660e8400-...", "770e8400-..."]
bulk_update_status(winter_products, is_active=False)

Best Practices

Update only what changed

Only include fields that need to be updated. Don’t send the entire product object:✅ Good:

{
  "stock": 200,
  "current_price": 799
}

❌ Bad:

{
  "name": "Same Name",
  "price": 1299,
  "description": "Same description...",
  "stock": 200,
  "current_price": 799,
  // ... all other unchanged fields
}

Sync inventory regularly

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

Schedule price updates

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

Batch updates efficiently

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

Use is_active for temporary removal

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

Create Product Delete Product

​Overview

​Endpoint

​Path Parameters

​Authentication

​Request Body

​Response

​Examples

​Update Price and Stock

​Success Response

​Update Multiple Fields

​Disable Product

​Update Images and Categories

​Error Responses

​400 Bad Request - No Fields to Update

​400 Bad Request - Validation Errors

​404 Not Found

​401 Unauthorized

​429 Too Many Requests

​Common Use Cases

​Inventory Sync

​Flash Sale

​Bulk Status Update

​Best Practices

​Next Steps

Create Product

Delete Product

Order APIs

Rate Limits

Overview

Endpoint

Path Parameters

Authentication

Request Body

Response

Examples

Update Price and Stock

Success Response

Update Multiple Fields

Disable Product

Update Images and Categories

Error Responses

400 Bad Request - No Fields to Update

400 Bad Request - Validation Errors

404 Not Found

401 Unauthorized

429 Too Many Requests

Common Use Cases

Inventory Sync

Flash Sale

Bulk Status Update

Best Practices

Next Steps