@salesforce/b2c-tooling-sdk / operations/sites
operations/sites
Site operations for B2C Commerce instances.
This module provides functions for managing site cartridge paths on B2C Commerce instances. Operations use SCAPI first, with temporary OCAPI and site-archive fallbacks. Business Manager (Sites-Site) is supported via the import/export mechanism.
Cartridge Path Functions
- getCartridgePath - Get the current cartridge path for a site
- addCartridge - Add a cartridge at a specific position
- removeCartridge - Remove a cartridge from the path
- setCartridgePath - Replace the entire cartridge path
Usage
typescript
import {getCartridgePath, addCartridge, setCartridgePath} from '@salesforce/b2c-tooling-sdk/operations/sites';
import {resolveConfig} from '@salesforce/b2c-tooling-sdk/config';
const config = resolveConfig();
const instance = config.createB2CInstance();
// List cartridge path
const result = await getCartridgePath(instance, 'RefArch');
console.log(result.cartridgeList);
// Add a cartridge
await addCartridge(instance, 'RefArch', { name: 'my_cartridge', position: 'first' });
// Business Manager
await addCartridge(instance, 'Sites-Site', { name: 'bm_ext', position: 'first' });Authentication
Cartridge path operations require OAuth authentication. For SCAPI direct updates, grant sfcc.sites.rw; for OCAPI grant POST/PUT/DELETE on /sites/∗/cartridges. For import/export fallback, grant job execution permissions and WebDAV write access.