Download OpenAPI specification:Download
API for managing product modifier groups
Retrieve a list of all product modifier groups with optional filtering and pagination
| page | integer >= 1 Default: 1 Page number for pagination |
| per_page | integer [ 1 .. 100 ] Default: 25 Number of items per page |
| sort | string Sort field |
| company_namespace | Array of strings Company namespace for filtering |
| disabled | boolean Filter by disabled status |
| _id | Array of strings Filter by ID |
{- "success": true,
- "data": [
- {
- "_id": "507f1f77bcf86cd799439011",
- "name": "Size Options",
- "description": "Available size options for products",
- "modifiers": [
- {
- "_id": "string",
- "name": "Large",
- "price_adjustment": 2.5,
- "description": "string"
}
], - "is_required": true,
- "max_selection": 1,
- "company_namespace": [
- "string"
], - "disabled": false,
- "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
], - "paging": {
- "total": 0,
- "page": 0,
- "per_page": 0,
- "pages": 0
}
}Create a new product modifier group entry
| name required | string Product modifier group name |
| description | string Group description |
Array of objects | |
| is_required | boolean Default: false Whether selecting a modifier from this group is required |
| max_selection | integer Default: 1 Maximum number of modifiers that can be selected |
| company_namespace | Array of strings Company namespace |
| disabled | boolean Default: false Whether the group is disabled |
{- "name": "Size Options",
- "description": "Available size options for products",
- "modifiers": [
- {
- "name": "string",
- "price_adjustment": 0,
- "description": "string"
}
], - "is_required": false,
- "max_selection": 1,
- "company_namespace": [
- "string"
], - "disabled": false
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "name": "Size Options",
- "description": "Available size options for products",
- "modifiers": [
- {
- "_id": "string",
- "name": "Large",
- "price_adjustment": 2.5,
- "description": "string"
}
], - "is_required": true,
- "max_selection": 1,
- "company_namespace": [
- "string"
], - "disabled": false,
- "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Retrieve a specific product modifier group by its ID
| id required | string Product modifier group ID |
{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "name": "Size Options",
- "description": "Available size options for products",
- "modifiers": [
- {
- "_id": "string",
- "name": "Large",
- "price_adjustment": 2.5,
- "description": "string"
}
], - "is_required": true,
- "max_selection": 1,
- "company_namespace": [
- "string"
], - "disabled": false,
- "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Update an existing product modifier group
| id required | string Product modifier group ID |
| name | string Product modifier group name |
| description | string Group description |
Array of objects | |
| is_required | boolean Whether selecting a modifier from this group is required |
| max_selection | integer Maximum number of modifiers that can be selected |
| company_namespace | Array of strings Company namespace |
| disabled | boolean Whether the group is disabled |
{- "name": "Size Options",
- "description": "string",
- "modifiers": [
- {
- "name": "string",
- "price_adjustment": 0,
- "description": "string"
}
], - "is_required": true,
- "max_selection": 0,
- "company_namespace": [
- "string"
], - "disabled": true
}{- "success": true,
- "data": {
- "_id": "507f1f77bcf86cd799439011",
- "name": "Size Options",
- "description": "Available size options for products",
- "modifiers": [
- {
- "_id": "string",
- "name": "Large",
- "price_adjustment": 2.5,
- "description": "string"
}
], - "is_required": true,
- "max_selection": 1,
- "company_namespace": [
- "string"
], - "disabled": false,
- "createdAt": "2019-08-24T14:15:22Z",
- "modifiedAt": "2019-08-24T14:15:22Z",
- "SVClient": 0,
- "__v": 0
}
}Delete multiple product modifier groups by their IDs
| ids required | Array of strings Array of product modifier group IDs to delete |
{- "ids": [
- "string"
]
}{- "success": true
}