get-products

Returns all products from the organization's product catalog. Products can be linked to assets and used as references for AI image generation.

Parameters

None.

Response

Field	Type	Description
insertProducts	array	List of products
insertProducts[].id	string	Product identifier
insertProducts[].name	string	Product name
insertProducts[].productImageUrl	string | null	URL of the main product image
insertProducts[].hasPackagingDistinction	boolean	Whether the product supports packaging vs. content distinction for AI generation
insertProducts[].createdAt	string	ISO date
insertProducts[].updatedAt	string	ISO date
total	number	Total number of products

Example

Request:

{
  "tool": "get-products",
  "arguments": {}
}

Response:

{
  "insertProducts": [
    {
      "id": "prod_abc123",
      "name": "Summer Collection T-Shirt",
      "productImageUrl": "https://cdn.heycreo.io/...",
      "hasPackagingDistinction": false,
      "createdAt": "2026-02-01T09:00:00.000Z",
      "updatedAt": "2026-03-15T11:00:00.000Z"
    }
  ],
  "total": 1
}

---

create-product

Create a product or person in the organization catalog.

Parameters

Parameter	Type	Required	Description
name	string	Yes	Display name
kind	"product" | "person"	No	Default product
assetId	string	No	Library asset id for the packaging/default image (prefer after begin-asset-upload / upload-asset)
unpackedAssetId	string	No	Library asset id for the unpacked/content image
imageUrl	string	No	HTTPS URL alternative to assetId (server downloads)
unpackedImageUrl	string	No	HTTPS URL alternative to unpackedAssetId
hasPackagingDistinction	boolean	No	Product only: packaging vs content images differ
propagateToSubtree	boolean	No	Make available to descendant workspaces

Prefer assetId over imageUrl when the file is already in the library — no second public fetch.

Example

{
  "tool": "create-product",
  "arguments": {
    "name": "Summer Collection T-Shirt",
    "assetId": "asset_abc123"
  }
}