ProductGroup

ProductGroup

List product groups

get

List all product groups.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

productGroupNamestringOptional

Reference to the name of a product group.

productGroupExternalIdstringOptional

External reference to a product group.

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

Responses

200

List of product groups

application/json

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/product-groups HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

List of product groups

{
  "items": [
    {
      "createdAt": "2025-07-30T18:12:15.162Z",
      "externalId": "text",
      "lastModifiedAt": "2025-07-30T18:12:15.162Z",
      "name": "text",
      "parentUid": "text",
      "productCount": 1,
      "productGroupUid": "text",
      "scope": "SALE"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new product group

post

Creates a new product group.

If parentUid is set and no scope is set, the new product group inherits scope from parent.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

all ofOptional

and

Responses

200

Example response

application/json

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/product-groups HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 94

{
  "externalId": "text",
  "name": "text",
  "parentUid": "text",
  "scope": "SALE",
  "productGroupUid": "text"
}

200

Example response

{
  "createdAt": "2025-07-30T18:12:15.162Z",
  "externalId": "text",
  "lastModifiedAt": "2025-07-30T18:12:15.162Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Get productgroup details

get

Get details for a product group.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/product-groups/{productGroupUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "createdAt": "2025-07-30T18:12:15.162Z",
  "externalId": "text",
  "lastModifiedAt": "2025-07-30T18:12:15.162Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Update product group

put

Update details for a product group. Partial updates are allowed.

If scope is set and different from current scope, the scope is changed for product group and all children for this product group.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

externalIdstringOptional

namestringRequired

parentUidstringOptionalPattern: ^[A-Za-z0-9-_]*

scopestring · enum · min: 1Optional

ENUM	Description
SALE	Sale product scope. Default
SERVICE	Service product scope
NO_SEARCH	Not visible in search scope

Possible values:

Responses

200

Example response

application/json

put

HTTPcURLJavaScriptPython

PUT /v2/tenants/{tenantUid}/product-groups/{productGroupUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 69

{
  "externalId": "text",
  "name": "text",
  "parentUid": "text",
  "scope": "SALE"
}

200

Example response

{
  "createdAt": "2025-07-30T18:12:15.162Z",
  "externalId": "text",
  "lastModifiedAt": "2025-07-30T18:12:15.162Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Delete product group

delete

Deletes a product group. The product group has to be empty.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

403

Forbidden

404

Not Found

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/product-groups/{productGroupUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List all links for a product group.

get

List all links for a product group.

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Query parameters

productGroupLinkTypestring · enumOptional

Reference to a productGroupLinkType.

Possible values:

pageNumberintegerOptional

Reference to a specific page in a result set.

pageSizeintegerOptional

The number of items per page in a result set.

sortBystringOptional

Defines which field the resource list is sorted by.

sortDirectionstring · enumOptional

ENUM	Description
ASC	Sort in ascending order
DESC	Sort in descending order

Possible values:

Responses

200

Example response

application/json

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/product-groups/{productGroupUid}/links HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "items": [
    {
      "productGroupLinkUid": "text",
      "linkType": "INSURANCE",
      "productUid": "text"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new link to a product group

post

Create new link to a product group

Require role tenant admin

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

Body

linkTypestring · enumRequiredPossible values:

productGroupLinkUidstringOptionalPattern: ^[A-Za-z0-9-_]+

productUidstringRequiredPattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

Responseall of

and

post

HTTPcURLJavaScriptPython

POST /v2/tenants/{tenantUid}/product-groups/{productGroupUid}/links HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "linkType": "INSURANCE",
  "productGroupLinkUid": "text",
  "productUid": "text"
}

200

Example response

{
  "productGroupLinkUid": "text",
  "linkType": "INSURANCE",
  "productUid": "text"
}

Get Product Group link details

get

Get Product group link details

Authorizations

accessTokenauthTokenintegrationToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productGroupLinkUidstringRequired

Reference to a Product group link.

Pattern: ^[A-Za-z0-9-_]+

Responses

200

Example response

application/json

Responseall of

and

get

HTTPcURLJavaScriptPython

GET /v2/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Example response

{
  "productGroupLinkUid": "text",
  "linkType": "INSURANCE",
  "productUid": "text"
}

Delete a product group link

delete

Delete a product group link

Require role tenant admin

Authorizations

authTokenintegrationTokenaccessToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

Pattern: ^[A-Za-z0-9-_]+

tenantUidstringRequired

Reference to a tenant.

Pattern: ^[A-Za-z0-9-_]+

productGroupLinkUidstringRequired

Reference to a Product group link.

Pattern: ^[A-Za-z0-9-_]+

Responses

204

No Content

delete

HTTPcURLJavaScriptPython

DELETE /v2/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid} HTTP/1.1
Host: api.flowretail.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

204

No Content

No content