Skip to main content

​
🔽 POST /api/public/product/upsert/{promptBlockId} – Upsert Products

Creates a list of products and their embeddings for a specific prompt block. Any product not included in the payload will be deleted, making this endpoint ideal for full refreshes. Click to expand full details

​
🔹 URL

POST /api/public/product/upsert/{promptBlockId}

​
🔹 Path Parameters

NameTypeRequiredDescription
promptBlockIdstring✅ID of the prompt block using the products

​
🔹 Headers

NameTypeRequiredDescription
x-api-keystring✅Your API key for authentication

​
🔹 Body Parameters

Send a list of product objects to define the current catalog. Each object typically contains: 
[
  {
    "id": "product_001",
    "name": "AI Coffee Mug",
    "description": "Ceramic mug with your assistant’s logo",
    "price": 12.99,
    "currency": "USD",
    "tags": ["mug", "merch", "coffee"]
  },
  {
    "id": "product_002",
    "name": "Smart T-Shirt",
    "description": "Black T-shirt with AI-powered design",
    "price": 24.50,
    "currency": "USD"
  }
]

​
🔹 Example Request

curl --request POST \
  'https://iris-backend-production.up.railway.app/api/public/product/upsert/prompt_abc123' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data-raw '[
    {
      "id": "product_001",
      "name": "AI Coffee Mug",
      "description": "Ceramic mug with your assistant’s logo",
      "price": 12.99,
      "currency": "USD"
    }
  ]'

​
🔹 Responses

CodeDescription
201Products upserted successfully
400Bad request (malformed body)
401Unauthorized (missing key)

​
🔽 GET /api/public/order/{id}/product – Get Product by Order ID

Retrieves product information tied to a specific order. Click to expand full details

​
🔹 URL

GET /api/public/order/{id}/product

​
🔹 Path Parameters

NameTypeRequiredDescription
idstring✅Order ID to retrieve the product from

​
🔹 Example Request

'https://api.vambe.me/api/public/order/abc123/product' ```
</CodeGroup>

---

### 🔹 Success Response

<CodeGroup>
```bash bash
{
  "id": "product_001",
  "name": "Custom T-Shirt",
  "description": "White cotton, printed front and back",
  "price": 29.99,
  "currency": "USD",
  "tags": ["tshirt", "clothing", "custom"]
}

​
🔹 Response Codes

CodeMeaningDescription
200OKProduct found
404Not FoundNo product found for the given order
👨🏽‍💻 Integration Guide 🔁 Pipelines Ask AI