Sign in

Update Collection SKUs

PUT https://{organization}.myguper.com/api/catalog/collection/{id}/skus/by/{interface}

Replaces the SKU set of a collection for a given interface. The body is a plain semicolon-separated string (NOT JSON). Each token is one of:

  • exact SKU: sku-123
  • numeric range: start:end (e.g. 500:600)
  • LIKE pattern: contains % or _ (e.g. ot%, %ot, %ot%). Patterns are stored lowercased and matched case-insensitively.

Token resolution order: pattern (%/_) → range (:) → exact. A token containing % is always treated as pattern, even if it also contains :.

This endpoint is "replace all": existing SKUs/ranges/patterns of the (collection, interface) pair are deleted before the new tokens are inserted.

Try-it values populated from environment ACME (Demo)


Authentication

Token

Send your user token in the x-guper-authorization header.

Headers

Name Type Description
x-guper-authorization * string User token issued by Guper.
Content-Type * string Use `text/plain` — the body is a raw semicolon-separated string, not JSON.

Path parameters

Name Type Description
id * integer Collection id.
interface * string External interface (e.g. `ecommerce`, `vtex`) the SKUs belong to.

Request body

Content-Type: text/plain

ot%; %ot; sku-exato-1; 500:600

Responses

{
    "success": true
}
Copied to clipboard