​
Description

Allows you to upsert items into the system, each with metadata and optional embedding data for use in the recommendation engine.

​
Request

Endpoint:

POST /items

Headers:

Authorization: Bearer <token>
Content-Type: application/json

Body Example:

{
  "entity_id": "item-123",
  "name": "Nike Running Shoes",
  "description": "High-performance running shoes.",
  "metadata": {
    "category": "Footwear",
    "brand": "Nike",
    "price": 109.99
  }
}

​
Response

200 OK

{
  "message": "Item upserted successfully"
}

​
Notes

  • Ensure unique entity_id per item.
  • Metadata can include any JSON-serializable fields.