Skip to main content
GET
/
api
/
public
/
product
/
product-blocks
Get product blocks to upsert products
curl --request GET \
  --url https://api.vambe.me/api/public/product/product-blocks \
  --header 'x-api-key: <x-api-key>'

​
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:
FieldTypeDescription
idstring (UUID)Product block identifier
namestringProduct block name
countnumberNumber 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 CodeDescription
401Unauthorized - Invalid or missing API key
403Forbidden - Insufficient permissions
500Internal Server Error

Headers

​
x-api-key
string
required

API key needed to authorize the request

Response

Product blocks retrieved successfully.