COM/COL requests

Quick answer

When your account takes COM/COL orders (comcol: true in app config), the shopper turns a render into a request: the piece, their details and the full spec of each fabric. Your team reviews it in Studio. Your systems read it through the Customer API or receive it by webhook.

The flow, in order

Method	Endpoint	What it does
POST	/visualizer/comcol/lookup	Fill in a fabric’s spec from what the shopper knows: { supplier?, pattern?, patternNo?, colorway?, url?, swatch? }. One of pattern, pattern number, swatch name or the fabric’s web page is required. Returns { hit }, or hit: null when nothing is found.
POST	/visualizer/comcol/order	Create or update the draft request: { orderId?, frameSku, productName?, quantity, customerName, customerEmail, customerPhone?, fabrics: [ … ] }. Up to three fabrics, each with swatchUrl plus whatever spec is known (supplier, pattern, color, widthIn, hRepeatIn, vRepeatIn, content, railroaded, placement). Returns { orderId, fabricId, status: "draft" }.
POST	/visualizer/comcol/order/{id}/verify	Checks the fabrics against your rules without changing anything: { ok, blocks, warnings }
POST	/visualizer/comcol/order/{id}/render-attach	Attach the approval render made with /visualizer/render: { runId, renderUrl? }
POST	/visualizer/comcol/order/{id}/submit	Sends it to your team: { id, status: "submitted_for_review", warnings }, or 422 verify_failed with the blocking problems

Create the draft

curl -X POST https://share.plunk.io/visualizer/comcol/order \
  -H "x-visualizer-key: sk_••••" -H "x-surface: com" -H "Content-Type: application/json" \
  -d '{
    "frameSku": "SF-1042",
    "productName": "Harbor Sofa",
    "quantity": 1,
    "customerName": "Jamie Rivera",
    "customerEmail": "jamie@example.com",
    "fabrics": [
      { "swatchUrl": "https://your.cdn/swatches/linen.jpg", "supplier": "…", "pattern": "…",
        "widthIn": 54, "hRepeatIn": 13.5, "vRepeatIn": 13.5, "railroaded": false, "placement": "body" }
    ]
  }'

Related

• Customer API: COM/COL requests
• Webhooks