omnilabs.shomnilabs.shdocs
Log InGet demo
ChannelReportingSaleProduct GroupProductWarehouseCarrierTemplateWebhooks
Log InGet demo

Product Group

Endpoints for managing product groups in the system.

# Endpoints

  • GET/product-groups# Retrieve a list of all product groups.
  • GET/product-group/{product_group_id}# Retrieve a specific product group by ID.
  • POST/product-group# Create a new product group.
  • PUT/product-group/{product_group_id}# Update an existing product group by ID.
  • DELETE/product-group/{product_group_id}# Delete a product group by ID.
  • POST/product-group/{product_group_id}/mark-default# Mark a product group as the default group.

Product Group

id

The unique identifier of the product group.

name

The name of the product group.

default

Indicates whether the product group is set as the default group.

warehouse_id

The ID of the warehouse associated with this product group.

channels

The list of channels associated with the product group.

link

The link to the feed associated with this product group.

{} The Product Group resource
1{
2  "id": "clymtb8gi0002maj3rj9o1ewh",
3  "name": "Default",
4  "default": true,
5  "warehouse_id": "clz2jbd5e0004tp3da285qm0c",
6  "channels": [
7    {
8      "id": "clysxnec500034rv0a82kaf2n"
9    }
10  ],
11  "link": "https://feed.omnilabs.sh/p/clymtb8gi0002maj3rj9o1ewh"
12}
get

Get List of Product Groups

Retrieve a list of all product groups.

cURL
curl -X GET "https://api.omnilabs.sh/product-groups" -H "Authorization: Bearer {{BEARER_TOKEN}}"
Response
[
  {
    "id": "clymtb8gi0002maj3rj9o1ewh",
    "name": "Default",
    "default": true,
    "warehouse_id": "clz2jbd5e0004tp3da285qm0c",
    "channels": [
      {
        "id": "clysxnec500034rv0a82kaf2n"
      }
    ],
    "link": "https://feed.omnilabs.sh/p/clymtb8gi0002maj3rj9o1ewh"
  }
]
get

Get Product Group by ID

Retrieve details of a specific product group by its ID.

cURL
curl -X GET "https://api.omnilabs.sh/product-group/clysu3k630005ocpc8stlgnvb" -H "Authorization: Bearer {{BEARER_TOKEN}}"

Parameters

product_group_idstringrequired

The unique ID of the product group.

Response
{
  "id": "clymtb8gi0002maj3rj9o1ewh",
  "name": "Default",
  "default": true,
  "warehouse_id": "clz2jbd5e0004tp3da285qm0c",
  "channels": [
    {
      "id": "clysxnec500034rv0a82kaf2n"
    }
  ],
  "link": "https://feed.omnilabs.sh/p/clymtb8gi0002maj3rj9o1ewh"
}
post

Create a Product Group

Create a new product group.

cURL
curl -X POST "https://api.omnilabs.sh/product-group" -H "Authorization: Bearer {{BEARER_TOKEN}}" -H "Content-Type: application/json" -d '{"name": "Test 4", "channels": [], "warehouse": null}'

Parameters

namestringrequired

The name of the new product group.

channelsstring[]optional

An array of channels to associate with the product group.

warehousestringoptional

The warehouse ID to associate with the product group.

Response
"ok"
put

Update a Product Group

Update an existing product group by ID.

cURL
curl -X PUT "https://api.omnilabs.sh/product-group/clymtb8gi0002maj3rj9o1ewh" -H "Authorization: Bearer {{BEARER_TOKEN}}" -H "Content-Type: application/json" -d '{"name": "Test 4", "channels": [], "warehouse": null}'

Parameters

namestringrequired

The new name for the product group.

channelsstring[]optional

An array of channels to associate with the product group.

warehousestringoptional

The warehouse ID to associate with the product group.

Response
"ok"
delete

Delete a Product Group

Delete a product group by ID.

cURL
curl -X DELETE "https://api.omnilabs.sh/product-group/clymtb8gi0002maj3rj9o1ewh" -H "Authorization: Bearer {{BEARER_TOKEN}}"

Parameters

product_group_idstringrequired

The unique ID of the product group to delete.

Response
"ok"
post

Mark Product Group as Default

Mark a product group as the default group.

cURL
curl -X POST "https://api.omnilabs.sh/product-group/clyd61crl0001l0aikvjg0yot/mark-default" -H "Authorization: Bearer {{BEARER_TOKEN}}"
Response
"ok"
© Omnilabs 2026. All rights reserved.