curl --request POST \
--url https://api.klavis.ai/sandbox/shopify/{sandbox_id}/initialize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"products": [
{
"title": "[Sandbox] Premium Cotton T-Shirt",
"description": "High-quality cotton t-shirt perfect for everyday wear",
"vendor": "Sandbox Apparel Co",
"category": "Apparel",
"price": "29.99",
"sku": "SAND-TSHIRT-001",
"stock": 100
},
{
"title": "[Sandbox] Wireless Bluetooth Headphones",
"description": "Premium noise-canceling headphones with 30-hour battery life",
"vendor": "Sandbox Electronics",
"category": "Electronics",
"price": "149.99",
"sku": "SAND-HEADPH-001",
"stock": 50
},
{
"title": "[Sandbox] Organic Coffee Beans - Dark Roast",
"description": "Ethically sourced, organic dark roast coffee beans",
"vendor": "Sandbox Coffee Roasters",
"category": "Food & Beverage",
"price": "18.99",
"sku": "SAND-COFFEE-001",
"stock": 200
},
{
"title": "[Sandbox] Yoga Mat - Eco Friendly",
"description": "Non-slip, eco-friendly yoga mat made from natural rubber",
"vendor": "Sandbox Fitness Gear",
"category": "Sports & Fitness",
"price": "45.00",
"sku": "SAND-YOGA-001",
"stock": 75
},
{
"title": "[Sandbox] Leather Wallet - Minimalist",
"description": "Handcrafted minimalist leather wallet with RFID protection",
"vendor": "Sandbox Leather Goods",
"category": "Accessories",
"price": "59.99",
"sku": "SAND-WALLET-001",
"stock": 60
},
{
"title": "[Sandbox] Smart Watch - Fitness Tracker",
"description": "Advanced fitness tracking with heart rate monitor and GPS",
"vendor": "Sandbox Tech",
"category": "Electronics",
"price": "199.99",
"sku": "SAND-WATCH-001",
"stock": 40
},
{
"title": "[Sandbox] Ceramic Coffee Mug Set",
"description": "Set of 4 handmade ceramic coffee mugs in various colors",
"vendor": "Sandbox Home Goods",
"category": "Home & Kitchen",
"price": "39.99",
"sku": "SAND-MUG-001",
"stock": 120
},
{
"title": "[Sandbox] Portable Phone Charger",
"description": "High-capacity 20000mAh portable battery pack with fast charging",
"vendor": "Sandbox Electronics",
"category": "Electronics",
"price": "34.99",
"sku": "SAND-CHARGER-001",
"stock": 150
},
{
"title": "[Sandbox] Stainless Steel Water Bottle",
"description": "Insulated water bottle keeps drinks cold for 24 hours",
"vendor": "Sandbox Outdoor Gear",
"category": "Sports & Fitness",
"price": "24.99",
"sku": "SAND-BOTTLE-001",
"stock": 180
},
{
"title": "[Sandbox] Backpack - Travel",
"description": "Durable travel backpack with laptop compartment",
"vendor": "Sandbox Travel Gear",
"category": "Bags & Luggage",
"price": "69.99",
"sku": "SAND-BACKPACK-001",
"stock": 90
}
],
"customers": [
{
"email": "[email protected]",
"name": "John Smith",
"address": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"zip": "94102",
"country": "US"
},
{
"email": "[email protected]",
"name": "Emma Wilson",
"address": "456 Oak Avenue",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US"
},
{
"email": "[email protected]",
"name": "Michael Chen",
"address": "789 Pine Road",
"city": "Seattle",
"state": "WA",
"zip": "98101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Sophia Martinez",
"address": "321 Elm Street",
"city": "Austin",
"state": "TX",
"zip": "78701",
"country": "US"
},
{
"email": "[email protected]",
"name": "Oliver Brown",
"address": "654 Maple Drive",
"city": "Boston",
"state": "MA",
"zip": "02101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Ava Johnson",
"address": "987 Cedar Lane",
"city": "Denver",
"state": "CO",
"zip": "80201",
"country": "US"
},
{
"email": "[email protected]",
"name": "Isabella Garcia",
"address": "258 Willow Way",
"city": "Miami",
"state": "FL",
"zip": "33101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Liam Miller",
"address": "369 Spruce Court",
"city": "Chicago",
"state": "IL",
"zip": "60601",
"country": "US"
}
],
"orders": [
{
"customer_index": 0,
"line_items": [
{
"product_index": 0,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 1,
"line_items": [
{
"product_index": 1,
"quantity": 1
}
],
"financial_status": "pending"
},
{
"customer_index": 2,
"line_items": [
{
"product_index": 2,
"quantity": 3
}
],
"financial_status": "paid"
},
{
"customer_index": 3,
"line_items": [
{
"product_index": 3,
"quantity": 1
},
{
"product_index": 4,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 4,
"line_items": [
{
"product_index": 5,
"quantity": 1
}
],
"financial_status": "pending"
},
{
"customer_index": 5,
"line_items": [
{
"product_index": 6,
"quantity": 4
}
],
"financial_status": "paid"
},
{
"customer_index": 6,
"line_items": [
{
"product_index": 7,
"quantity": 1
},
{
"product_index": 8,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 7,
"line_items": [
{
"product_index": 9,
"quantity": 1
}
],
"financial_status": "pending"
}
]
}
'{
"sandbox_id": "<string>",
"status": "idle",
"message": "<string>",
"records_created": {}
}Initialize the sandbox with shopify-specific data following the defined schema.
curl --request POST \
--url https://api.klavis.ai/sandbox/shopify/{sandbox_id}/initialize \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"products": [
{
"title": "[Sandbox] Premium Cotton T-Shirt",
"description": "High-quality cotton t-shirt perfect for everyday wear",
"vendor": "Sandbox Apparel Co",
"category": "Apparel",
"price": "29.99",
"sku": "SAND-TSHIRT-001",
"stock": 100
},
{
"title": "[Sandbox] Wireless Bluetooth Headphones",
"description": "Premium noise-canceling headphones with 30-hour battery life",
"vendor": "Sandbox Electronics",
"category": "Electronics",
"price": "149.99",
"sku": "SAND-HEADPH-001",
"stock": 50
},
{
"title": "[Sandbox] Organic Coffee Beans - Dark Roast",
"description": "Ethically sourced, organic dark roast coffee beans",
"vendor": "Sandbox Coffee Roasters",
"category": "Food & Beverage",
"price": "18.99",
"sku": "SAND-COFFEE-001",
"stock": 200
},
{
"title": "[Sandbox] Yoga Mat - Eco Friendly",
"description": "Non-slip, eco-friendly yoga mat made from natural rubber",
"vendor": "Sandbox Fitness Gear",
"category": "Sports & Fitness",
"price": "45.00",
"sku": "SAND-YOGA-001",
"stock": 75
},
{
"title": "[Sandbox] Leather Wallet - Minimalist",
"description": "Handcrafted minimalist leather wallet with RFID protection",
"vendor": "Sandbox Leather Goods",
"category": "Accessories",
"price": "59.99",
"sku": "SAND-WALLET-001",
"stock": 60
},
{
"title": "[Sandbox] Smart Watch - Fitness Tracker",
"description": "Advanced fitness tracking with heart rate monitor and GPS",
"vendor": "Sandbox Tech",
"category": "Electronics",
"price": "199.99",
"sku": "SAND-WATCH-001",
"stock": 40
},
{
"title": "[Sandbox] Ceramic Coffee Mug Set",
"description": "Set of 4 handmade ceramic coffee mugs in various colors",
"vendor": "Sandbox Home Goods",
"category": "Home & Kitchen",
"price": "39.99",
"sku": "SAND-MUG-001",
"stock": 120
},
{
"title": "[Sandbox] Portable Phone Charger",
"description": "High-capacity 20000mAh portable battery pack with fast charging",
"vendor": "Sandbox Electronics",
"category": "Electronics",
"price": "34.99",
"sku": "SAND-CHARGER-001",
"stock": 150
},
{
"title": "[Sandbox] Stainless Steel Water Bottle",
"description": "Insulated water bottle keeps drinks cold for 24 hours",
"vendor": "Sandbox Outdoor Gear",
"category": "Sports & Fitness",
"price": "24.99",
"sku": "SAND-BOTTLE-001",
"stock": 180
},
{
"title": "[Sandbox] Backpack - Travel",
"description": "Durable travel backpack with laptop compartment",
"vendor": "Sandbox Travel Gear",
"category": "Bags & Luggage",
"price": "69.99",
"sku": "SAND-BACKPACK-001",
"stock": 90
}
],
"customers": [
{
"email": "[email protected]",
"name": "John Smith",
"address": "123 Main Street",
"city": "San Francisco",
"state": "CA",
"zip": "94102",
"country": "US"
},
{
"email": "[email protected]",
"name": "Emma Wilson",
"address": "456 Oak Avenue",
"city": "New York",
"state": "NY",
"zip": "10001",
"country": "US"
},
{
"email": "[email protected]",
"name": "Michael Chen",
"address": "789 Pine Road",
"city": "Seattle",
"state": "WA",
"zip": "98101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Sophia Martinez",
"address": "321 Elm Street",
"city": "Austin",
"state": "TX",
"zip": "78701",
"country": "US"
},
{
"email": "[email protected]",
"name": "Oliver Brown",
"address": "654 Maple Drive",
"city": "Boston",
"state": "MA",
"zip": "02101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Ava Johnson",
"address": "987 Cedar Lane",
"city": "Denver",
"state": "CO",
"zip": "80201",
"country": "US"
},
{
"email": "[email protected]",
"name": "Isabella Garcia",
"address": "258 Willow Way",
"city": "Miami",
"state": "FL",
"zip": "33101",
"country": "US"
},
{
"email": "[email protected]",
"name": "Liam Miller",
"address": "369 Spruce Court",
"city": "Chicago",
"state": "IL",
"zip": "60601",
"country": "US"
}
],
"orders": [
{
"customer_index": 0,
"line_items": [
{
"product_index": 0,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 1,
"line_items": [
{
"product_index": 1,
"quantity": 1
}
],
"financial_status": "pending"
},
{
"customer_index": 2,
"line_items": [
{
"product_index": 2,
"quantity": 3
}
],
"financial_status": "paid"
},
{
"customer_index": 3,
"line_items": [
{
"product_index": 3,
"quantity": 1
},
{
"product_index": 4,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 4,
"line_items": [
{
"product_index": 5,
"quantity": 1
}
],
"financial_status": "pending"
},
{
"customer_index": 5,
"line_items": [
{
"product_index": 6,
"quantity": 4
}
],
"financial_status": "paid"
},
{
"customer_index": 6,
"line_items": [
{
"product_index": 7,
"quantity": 1
},
{
"product_index": 8,
"quantity": 2
}
],
"financial_status": "paid"
},
{
"customer_index": 7,
"line_items": [
{
"product_index": 9,
"quantity": 1
}
],
"financial_status": "pending"
}
]
}
'{
"sandbox_id": "<string>",
"status": "idle",
"message": "<string>",
"records_created": {}
}Your Klavis AI API key.
The unique sandbox identifier
If true, use default test data for initialization
Complete Shopify sandbox data structure.
Orders reference customers and products by their index in the respective lists. Products and customers are created first, then orders are created with proper references.
Successful Response
Response model for sandbox initialization