Product catalog

curl -X POST https://fliok.com/api/v1/catalog/images \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://cdn.mithaighar.in/kaju-katli-500g.jpg" }'

curl -X POST https://fliok.com/api/v1/catalog/products \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kaju-katli-500g" \
  -d '{
    "name": "Kaju katli (500 g)",
    "price": "649",
    "currency": "INR",
    "imageKey": "catalog/7c1e…/4b2d9f0e-….jpg",
    "retailerId": "KK-500",
    "description": "Made fresh every morning with pure ghee.",
    "url": "https://mithaighar.in/kaju-katli"
  }'

// 201 Created — POST /catalog/images
{ "imageKey": "catalog/7c1e…/4b2d9f0e-….jpg", "contentType": "image/jpeg", "size": 184213 }

// 201 Created — POST /catalog/products: pushed to Meta at once
{
  "product": {
    "id": "5e0b7a8c-2f4d-4b1e-9c3a-7d6e5f4a3b21",
    "retailerId": "KK-500",
    "name": "Kaju katli (500 g)",
    "description": "Made fresh every morning with pure ghee.",
    "priceMinor": 64900,
    "currency": "INR",
    "imageUrl": "https://fliok.com/api/public/product-image/5e0b7a8c-2f4d-4b1e-9c3a-7d6e5f4a3b21?v=4b2d9f0e",
    "url": "https://mithaighar.in/kaju-katli",
    "availability": "in stock",
    "brand": null,
    "syncStatus": "synced",
    "inMeta": true,
    "lastError": null,
    "syncedAt": "2026-10-29T06:30:04.000Z",
    "createdAt": "2026-10-29T06:30:02.000Z",
    "updatedAt": "2026-10-29T06:30:04.000Z"
  }
}

curl "https://fliok.com/api/v1/catalog" -H "Authorization: Bearer wa_YOUR_API_KEY"

curl "https://fliok.com/api/v1/catalog/products?q=katli&synced=true&limit=20" \
  -H "Authorization: Bearer wa_YOUR_API_KEY"

curl -X PATCH https://fliok.com/api/v1/catalog/products/5e0b7a8c-2f4d-4b1e-9c3a-7d6e5f4a3b21 \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "price": 699, "availability": "out of stock" }'

// 200 OK — GET /catalog (never the token)
{
  "connected": true,
  "catalog": {
    "id": "1187654321098765",
    "name": "Mithai Ghar",
    "linkedToWhatsApp": true,
    "catalogVisible": true,
    "cartEnabled": true,
    "lastError": null,
    "lastSyncAt": "2026-10-29T06:30:04.000Z"
  },
  "products": { "total": 42, "synced": 40, "pending": 1, "error": 1 }
}

// 200 OK — GET /catalog/products
{ "products": [ { "id": "5e0b…", "retailerId": "KK-500", "name": "Kaju katli (500 g)", "priceMinor": 64900, … } ], "nextCursor": null }

// 200 OK — PATCH: only price and stock changed, pushed to Meta again
{ "product": { "id": "5e0b…", "priceMinor": 69900, "availability": "out of stock", "syncStatus": "synced", "inMeta": true, … } }

curl -X POST https://fliok.com/api/v1/catalog/send \
  -H "Authorization: Bearer wa_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: diwali-box-9f1c" \
  -d '{
    "conversationId": "9f1c2b7e-5d1a-4c3e-9b0a-2f6d8e7c1a44",
    "kind": "product_list",
    "header": "Diwali sweets",
    "body": "Here are this week’s boxes. Tap one to order.",
    "productIds": ["5e0b7a8c-2f4d-4b1e-9c3a-7d6e5f4a3b21", "a3c9e1f2-7b6d-4e5a-8c9b-0d1e2f3a4b5c"]
  }'

// 200 OK — queued on the ordinary send path; delivery comes as message.status webhooks
{ "ok": true, "messageId": "0c8d6e4f-1a2b-4c3d-9e8f-7a6b5c4d3e2f" }

// 422 — the customer last wrote more than 24 hours ago
{ "error": "outside_24h_window" }