Get product blocks to upsert products

Overview

Get all product blocks (prompt blocks) configured for your organization. Product blocks are containers that hold related products and are used by AI assistants to recommend products to customers. Use this endpoint to see which product blocks you can manage with the create, upsert, and delete endpoints.

Use Cases

List Available Catalogs: See all product catalogs you can manage
Integration Setup: Get block IDs for product sync operations
Catalog Selection: Allow users to select which catalog to update
Validation: Verify block exists before product operations

Authentication

x-api-key: your_api_key_here

Response Structure

Returns an array of product block objects:

Field	Type	Description
`id`	string (UUID)	Product block identifier
`name`	string	Product block name
`count`	number	Number of products in this block

Example Request

curl --request GET \
  'https://api.vambe.ai/api/public/product/product-blocks' \
  --header 'x-api-key: your_api_key_here'

Example Response

[
  {
    "id": "block-abc123",
    "name": "Main Product Catalog",
    "count": 150
  },
  {
    "id": "block-def456",
    "name": "Seasonal Products",
    "count": 25
  }
]

Error Responses

Status Code	Description
401	Unauthorized - Invalid or missing API key
403	Forbidden - Insufficient permissions
500	Internal Server Error

POST /api/public/product/create/ - Add products to block
POST /api/public/product/upsert/ - Sync entire catalog
POST /api/public/product/delete/ - Remove products

Headers

x-api-key

string

required

API key needed to authorize the request

Response

Product blocks retrieved successfully.

Product Catalog

​Overview

​Use Cases

​Authentication

​Response Structure

​Example Request

​Example Response

​Error Responses

​Related Endpoints