catalog

Embed

<a href="https://hermeticor.com/docs/ref-catalog"><img src="https://hermeticor.com/docs/_api/public/orgs/5fcd8b3c-a27c-4688-972f-de710125592f/spaces/caf5dc05-15f7-4e0c-bdb8-ab29ede6211e/pages/9fc720ba-4c3d-4e83-bd29-1f3b952f36da/social-card.svg?v=3e7ae33eec8b" alt="catalog" width="600" height="315"></a>

PUThttps://hermeticor.com/v1/catalog/items/{id}/variants/{variantId}

Create the variant under this external id, or replace it

Parameters

idstringpathrequired

variantIdstringpathrequired

Request body

application/json

skustring

titlestringrequired

priceMinorinteger

currencystring

inventoryinteger

urlstring

imageUrlstring

publishedboolean

inventoryPolicystring

deny | continue

backordersstring

visibilitystring

imageThumbnailUrlstring

customMetadataobject

{
  "sku": "string",
  "title": "string",
  "priceMinor": 0,
  "currency": "string",
  "inventory": 0,
  "url": "string",
  "imageUrl": "string",
  "published": true,
  "inventoryPolicy": "deny",
  "backorders": "string",
  "visibility": "string",
  "imageThumbnailUrl": "string",
  "customMetadata": {}
}

Code samples

cURL

curl -X PUT "https://hermeticor.com/v1/catalog/items/{id}/variants/{variantId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku":"string","title":"string","priceMinor":0,"currency":"string","inventory":0,"url":"string","imageUrl":"string","published":true,"inventoryPolicy":"deny","backorders":"string","visibility":"string","imageThumbnailUrl":"string","customMetadata":{}}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "id": "string",
  "itemId": "string",
  "externalId": "string",
  "sku": "string",
  "title": "string",
  "priceMinor": 0,
  "currency": "string",
  "inventory": 0,
  "url": "string",
  "imageUrl": "string",
  "published": true,
  "inventoryPolicy": "deny",
  "backorders": "string",
  "visibility": "string",
  "imageThumbnailUrl": "string",
  "customMetadata": {}
}

Schema

idstringrequired

itemIdstringrequired

externalIdstringrequired

skustringrequired

titlestringrequired

priceMinorintegerrequired

currencystringrequired

inventoryintegerrequired

urlstringrequired

imageUrlstringrequired

publishedbooleanrequired

inventoryPolicystringrequired

deny | continue

backordersstringrequired

visibilitystringrequired

imageThumbnailUrlstringrequired

customMetadataobjectrequired

4XX Default Response

Example

{
  "error": {
    "code": "string",
    "message": "string",
    "details": {}
  }
}

Schema

errorobjectrequired

Show child parameters

codestringrequired

messagestringrequired

detailsobject

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

GEThttps://hermeticor.com/v1/catalog/items/{id}/images

Parameters

limitintegerquery

Page size; omitted returns the whole list

cursorstringquery

Opaque: the nextCursor of the previous page

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/catalog/items/{id}/images" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "itemId": "string",
      "url": "string",
      "position": 0,
      "variantIds": [
        "string"
      ]
    }
  ],
  "nextCursor": "string"
}

Schema

itemsItemsItem93[]required

Show child parameters

idstringrequired

itemIdstringrequired

urlstringrequired

positionintegerrequired

variantIdsstring[]required

nextCursorstringrequired

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

POSThttps://hermeticor.com/v1/catalog/items/{id}/images

Parameters

idstringpathrequired

Request body

application/json

urlstringrequired

positioninteger

variantIdsstring[]

{
  "url": "string",
  "position": 0,
  "variantIds": [
    "string"
  ]
}

Code samples

cURL

curl -X POST "https://hermeticor.com/v1/catalog/items/{id}/images" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"string","position":0,"variantIds":["string"]}'

TypeScript

Python

PHP

Ruby

Java

Responses

201 Default Response

Example

{
  "id": "string",
  "itemId": "string",
  "url": "string",
  "position": 0,
  "variantIds": [
    "string"
  ]
}

Schema

idstringrequired

itemIdstringrequired

urlstringrequired

positionintegerrequired

variantIdsstring[]required

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

GEThttps://hermeticor.com/v1/catalog/items/{id}/images/{imageId}

Parameters

idstringpathrequired

imageIdstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/catalog/items/{id}/images/{imageId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 201 · POST /v1/catalog/items/{id}/images

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

DELETEhttps://hermeticor.com/v1/catalog/items/{id}/images/{imageId}

Parameters

idstringpathrequired

imageIdstringpathrequired

Code samples

cURL

curl -X DELETE "https://hermeticor.com/v1/catalog/items/{id}/images/{imageId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "ok": true
}

Schema

okbooleanrequired

true

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

PATCHhttps://hermeticor.com/v1/catalog/items/{id}/images/{imageId}

Parameters

idstringpathrequired

imageIdstringpathrequired

Request body

application/json

urlstring

positioninteger

variantIdsstring[]

{
  "url": "string",
  "position": 0,
  "variantIds": [
    "string"
  ]
}

Code samples

cURL

curl -X PATCH "https://hermeticor.com/v1/catalog/items/{id}/images/{imageId}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"string","position":0,"variantIds":["string"]}'

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 201 · POST /v1/catalog/items/{id}/images

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

GEThttps://hermeticor.com/v1/catalog/variants

Filter by ids, sku, title, published or item; page with nextCursor

Parameters

limitintegerquery

= 100

cursorstringquery

idsstringquery

skustringquery

titlestringquery

publishedstringquery

true | false

itemstringquery

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/catalog/variants" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Example

{
  "items": [
    {
      "id": "string",
      "itemId": "string",
      "externalId": "string",
      "sku": "string",
      "title": "string",
      "priceMinor": 0,
      "currency": "string",
      "inventory": 0,
      "url": "string",
      "imageUrl": "string",
      "published": true,
      "inventoryPolicy": "deny",
      "backorders": "string",
      "visibility": "string",
      "imageThumbnailUrl": "string",
      "customMetadata": {}
    }
  ],
  "nextCursor": "string"
}

Schema

itemsVariantsItem4[]required

Show child parameters

idstringrequired

itemIdstringrequired

externalIdstringrequired

skustringrequired

titlestringrequired

priceMinorintegerrequired

currencystringrequired

inventoryintegerrequired

urlstringrequired

imageUrlstringrequired

publishedbooleanrequired

inventoryPolicystringrequired

deny | continue

backordersstringrequired

visibilitystringrequired

imageThumbnailUrlstringrequired

customMetadataobjectrequired

nextCursorstringrequired

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

GEThttps://hermeticor.com/v1/catalog/variants/{id}

Parameters

idstringpathrequired

Code samples

cURL

curl -X GET "https://hermeticor.com/v1/catalog/variants/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · PUT /v1/catalog/items/{id}/variants/{variantId}

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

DELETEhttps://hermeticor.com/v1/catalog/variants/{id}

Parameters

idstringpathrequired

Code samples

cURL

curl -X DELETE "https://hermeticor.com/v1/catalog/variants/{id}" \
  -H "Authorization: Bearer $HERMETICOR_API_KEY"

TypeScript

Python

PHP

Ruby

Java

Responses

200 Default Response

Same as 200 · DELETE /v1/catalog/items/{id}/images/{imageId}

4XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

5XX Default Response

Same as 4XX · PUT /v1/catalog/items/{id}/variants/{variantId}

Next part

Updated Nov 8, 2026

Was this page helpful?