ProductGroup

ProductGroup

List product groups

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups

List all product groups.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

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

/tenants/{tenantUid}/product-groups

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-12-13T11:43:31.806Z",
      "externalId": "text",
      "lastModifiedAt": "2025-12-13T11:43:31.806Z",
      "name": "text",
      "parentUid": "text",
      "productCount": 1,
      "productGroupUid": "text",
      "scope": "SALE"
    }
  ],
  "paging": {
    "pageNumber": 1,
    "pageSize": 1,
    "totalCount": 1
  }
}

Create new product group

post

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups

Creates a new product group.

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

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

tenantUidstringRequired

Reference to a tenant.

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

Body

application/json

and

Responses

200

Example response

application/json

post

/tenants/{tenantUid}/product-groups

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-12-13T11:43:31.806Z",
  "externalId": "text",
  "lastModifiedAt": "2025-12-13T11:43:31.806Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Get productgroup details

get

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}

Get details for a product group.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

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

/tenants/{tenantUid}/product-groups/{productGroupUid}

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-12-13T11:43:31.806Z",
  "externalId": "text",
  "lastModifiedAt": "2025-12-13T11:43:31.806Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Update product group

put

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}

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

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

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

tenantUidstringRequired

Reference to a tenant.

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

Body

application/json

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

/tenants/{tenantUid}/product-groups/{productGroupUid}

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-12-13T11:43:31.806Z",
  "externalId": "text",
  "lastModifiedAt": "2025-12-13T11:43:31.806Z",
  "name": "text",
  "parentUid": "text",
  "productCount": 1,
  "productGroupUid": "text",
  "scope": "SALE"
}

Delete product group

delete

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}

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

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

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

/tenants/{tenantUid}/product-groups/{productGroupUid}

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}/links

List all links for a product group.

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

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

/tenants/{tenantUid}/product-groups/{productGroupUid}/links

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}/links

Create new link to a product group

Require role tenant admin

Authorizations

authTokenintegrationTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

Path parameters

productGroupUidstringRequired

Reference to a ProductGroup.

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

tenantUidstringRequired

Reference to a tenant.

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

Body

application/json

linkTypestring · enumRequiredPossible values:

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

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

Responses

200

Example response

application/json

post

/tenants/{tenantUid}/product-groups/{productGroupUid}/links

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid}

Get Product group link details

Authorizations

accessTokenauthTokenintegrationToken

AuthorizationstringRequired

Accesstoken recevied after user login with a deviceToken

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

get

/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid}

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

https://api.flowretail.com/v2https://api.stage.flowretail.com/v2

/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid}

Delete a product group link

Require role tenant admin

Authorizations

authTokenintegrationTokenaccessToken

AuthorizationstringRequired

Token received from the auth service

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

/tenants/{tenantUid}/product-groups/{productGroupUid}/links/{productGroupLinkUid}

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