@salesforce/b2c-tooling-sdk 2.4.0 → 2.5.0

package/node_modules/@salesforce/b2c-api-schemas/scapi/product/shopper-availability/v1.json

@@ -2,7 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Shopper Availability",
-    "version": "1.4.0",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/shopper-availability/shopper-availability-oas-v1-public.yaml)\n\n# API Overview\n\nUse the Shopper Availability API enables to retrieve inventory availability for products without fetching full product details. This allows independent caching strategies for volatile availability data and stable product data.\n\nUse `/availability` to retrieve availability for products. If the `inventoryIds` parameter is omitted, availability is returned from the site-assigned default inventory list. If `inventoryIds` is provided, availability is returned only from the specified inventory lists.\n\nCaching is provided for the Shopper Availability API. For details, see [Server-Side Web-Tier Caching.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/server-side-web-tier-caching.html)\n\n## Authentication & Authorization\n\nThe client requesting the availability information must have access to the Availability resource. The Shopper Availability API requires a shopper access token from the Shopper Login and API Access Service (SLAS).\n\nYou must include the relevant scopes in the client ID used to generate the SLAS token. For a full list of required permissions, see the [Authorization Scopes Catalog.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html)\n\nFor details on how to request a shopper access token from SLAS, see the guest user flows for [public clients](https://developer.salesforce.com/docs/commerce/commerce-api/guide/slas-public-client.html#guest-user) and [private clients](https://developer.salesforce.com/docs/commerce/commerce-api/guide/slas-private-client.html#guest-user) in the SLAS guides.\n\n## Use Cases\n\n### Retrieve Product Availability\n\nUse the Shopper Availability API so that a customer can see whether products are in stock. This API returns availability details, including stock levels and inventory status, for up to 24 products per request.\n\n### Retrieve Availability from Specific Inventory Lists\n\nUse the `inventoryIds` parameter to retrieve availability from specific inventory lists rather than the site-assigned default. This is useful for scenarios such as showing availability at specific store locations or warehouses. You can request availability from up to 5 inventory lists per request.\n\n### Retrieve Availability for Product Variations\n\nUse the `expand=variations` parameter to retrieve availability for all variants of a master product in a single request. Use the `productId` from each entry in the Shopper Products API `variants` array to look up availability for a specific variant.\n\n## Use Hooks\n\nFor details working with hooks, see [Extensibility with Hooks.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/extensibility_via_hooks.html)",
+    "version": "1.4.2",
     "x-api-type": "Shopper",
     "x-api-family": "Product"
   },
@@ -11,6 +12,7 @@
       "url": "https://{shortCode}.api.commercecloud.salesforce.com/product/shopper-availability/v1",
       "variables": {
         "shortCode": {
+          "description": "An eight-character string assigned to a realm for routing purposes. See [Base URL and Request Formation.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html)",
           "default": "shortCode"
         }
       }
@@ -19,26 +21,35 @@
   "paths": {
     "/organizations/{organizationId}/availability": {
       "get": {
+        "summary": "Returns availability for multiple products.",
+        "description": "Returns availability for multiple products. If `inventoryIds` is omitted, availability is returned from the site-assigned default inventory list. If `inventoryIds` is provided, availability is returned only from the specified inventory lists. The maximum number of product IDs that you can request is 24. The maximum number of inventory list IDs you can request is 5. The `productIds` parameter accepts product IDs for any product type (master, variant, standard, set, or bundle). Products that are offline or not found are silently filtered from the response. To retrieve availability for all variants of a master product, use the `expand=variations` parameter. Use the `productId` from each entry in the Shopper Products API `variants` array to look up availability for a specific variant.",
         "operationId": "getAvailability",
         "parameters": [
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "productIds",
             "in": "query",
+            "description": "The IDs of the requested products (comma-separated, max 24 IDs). If more than 24 IDs are required, split them into multiple parallel requests. Products that are offline or not found are silently filtered from the response.",
             "required": true,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "apple-ipod-shuffle",
+                "apple-ipod-nano"
+              ],
               "items": {
                 "allOf": [
                   {
@@ -48,16 +59,22 @@
               },
               "maxItems": 24,
               "minItems": 1
-            }
+            },
+            "example": "apple-ipod-shuffle,apple-ipod-nano"
           },
           {
             "name": "inventoryIds",
             "in": "query",
+            "description": "The inventory list IDs for which the availability should be shown (comma-separated, max 5 inventory list IDs). If omitted, availability is returned from the site-assigned default inventory list. If provided, availability is returned only from the specified inventory lists.",
             "required": false,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "Site1InventoryList",
+                "Site2InventoryList"
+              ],
               "items": {
                 "allOf": [
                   {
@@ -67,63 +84,66 @@
               },
               "maxItems": 5,
               "minItems": 1
-            }
+            },
+            "example": "Site1InventoryList,Site2InventoryList"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           },
           {
             "name": "expand",
             "in": "query",
+            "description": "Expand the response to include availability for related products. When `variations` is specified, availability for all variation products of a master product is included. When `set_products` is specified, availability for all products in a product set is included. The parent product's availability is always included alongside the expanded entries. Expansion is single-level only: if a variation is itself a product set, its set products are not further expanded. Other product types (bundles, bundled items, set items) are not expanded. Expanded results are returned flat at the top level of the response array, not nested below their parent product.\n**Note:** When using `expand=variations`, combine this response with variant data from the Shopper Products API to determine which specific variant attribute combinations (e.g. size=L, color=red) are orderable. Use the `productId` from each entry in the Shopper Products API `variants` array as the key to look up availability for that variant in this response.",
             "required": false,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "variations",
+                "set_products"
+              ],
               "items": {
                 "type": "string",
                 "enum": [
                   "variations",
                   "set_products"
-                ]
+                ],
+                "example": "variations"
               }
-            }
+            },
+            "example": "variations,set_products"
           },
           {
             "name": "sfdc_usid",
             "in": "header",
+            "description": "A unique shopper identifier (USID) for tracking client context.\nUsed with endpoints secured with ShopperClientContextToken.\nThis header is required for all endpoints secured with ShopperClientContextToken.",
             "required": false,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
-              "format": "uuid"
-            }
-          },
-          {
-            "name": "sfdc_dw_dnt",
-            "in": "header",
-            "required": false,
-            "style": "simple",
-            "explode": false,
-            "schema": {
-              "type": "string",
-              "enum": [
-                "0",
-                "1"
-              ]
+              "format": "uuid",
+              "example": "550e8400-e29b-41d4-a716-446655440000"
             }
           },
           {
             "name": "personalized",
             "in": "query",
+            "description": "Controls whether personalization is applied to the response. When set to `none`, the server skips applying personalization to the response.",
             "required": false,
             "style": "form",
             "explode": true,
@@ -131,12 +151,14 @@
               "type": "string",
               "enum": [
                 "none"
-              ]
+              ],
+              "example": "none"
             }
           },
           {
             "name": "sfdc_shopper_context",
             "in": "header",
+            "description": "Shopper context information (for example clientIP, sourceCode, and customQualifiers)\npassed in from a trusted backend application.",
             "required": false,
             "style": "simple",
             "explode": false,
@@ -152,6 +174,14 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/AvailabilityResult"
+                },
+                "examples": {
+                  "GetAvailabilityResponseExample": {
+                    "$ref": "#/components/examples/GetAvailabilityResponseExample"
+                  },
+                  "GetAvailabilityInventoryListsResponseExample": {
+                    "$ref": "#/components/examples/GetAvailabilityInventoryListsResponseExample"
+                  }
                 }
               }
             }
@@ -162,6 +192,17 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "GetAvailabilityBadRequestResponseExample": {
+                    "$ref": "#/components/examples/GetAvailabilityBadRequestResponseExample"
+                  },
+                  "GetAvailabilityInventoryListsBadRequestResponseExample": {
+                    "$ref": "#/components/examples/GetAvailabilityInventoryListsBadRequestResponseExample"
+                  },
+                  "MalformedSelectorResponseExample": {
+                    "$ref": "#/components/examples/MalformedSelectorResponseExample"
+                  }
                 }
               }
             }
@@ -216,49 +257,70 @@
     "schemas": {
       "OrganizationId": {
         "type": "string",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+        "example": "f_ecom_zzxy_prd",
         "pattern": "^f_ecom_[a-z]{4}_(prd|stg|dev|s[0-9]{2}|[0-9]{3})$"
       },
       "ProductId": {
         "type": "string",
+        "description": "The id (SKU) of the product.",
+        "example": "apple-ipod-classic",
         "maxLength": 100,
         "minLength": 1
       },
       "InventoryId": {
         "type": "string",
+        "description": "The inventory ID.",
+        "example": "Site1InventoryList",
         "maxLength": 256,
         "minLength": 1
       },
       "SiteId": {
         "type": "string",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites",
+        "example": "RefArch",
         "maxLength": 32,
         "minLength": 1
       },
       "Inventory": {
         "type": "object",
+        "description": "Document representing inventory information of the current product for a particular inventory list.",
         "properties": {
           "ats": {
             "type": "number",
-            "format": "double"
+            "format": "double",
+            "description": "The Available To Sell (ATS) of the product. If it is infinity, the return value is 999999. The value can be overwritten by the\n OCAPI setting 'product.inventory.ats.max_threshold'.",
+            "example": 15
           },
           "backorderable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "A flag indicating whether the product is backorderable.",
+            "example": true
           },
           "id": {
             "$ref": "#/components/schemas/InventoryId"
           },
           "inStockDate": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "A flag indicating the date when the product will be in stock.",
+            "example": "9999-12-31T00:00:00Z"
           },
           "orderable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "A flag indicating whether at least one of the products is available to sell.",
+            "example": true
           },
           "preorderable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "A flag indicating whether the product is preorderable.",
+            "example": false
           },
           "stockLevel": {
             "type": "number",
-            "format": "double"
+            "format": "double",
+            "description": "The stock level of the product. If it is infinity, the return value is 999999. The value can be overwritten by the\n OCAPI setting 'product.inventory.stock_level.max_threshold'.",
+            "example": 10
           }
         },
         "required": [
@@ -267,12 +329,14 @@
       },
       "Availability": {
         "type": "object",
+        "description": "Availability of one product across the requested inventory lists, or the site-assigned default inventory list.",
         "properties": {
           "id": {
             "$ref": "#/components/schemas/ProductId"
           },
           "inventories": {
             "type": "array",
+            "description": "The array of inventory information for the product.",
             "items": {
               "$ref": "#/components/schemas/Inventory"
             }
@@ -285,20 +349,26 @@
       },
       "AvailabilityResult": {
         "type": "object",
+        "description": "Result document containing an array of product availability.",
         "properties": {
           "limit": {
             "type": "integer",
-            "format": "int32"
+            "format": "int32",
+            "description": "The number of returned product entries in the data array.",
+            "example": 2
           },
           "data": {
             "type": "array",
+            "description": "The array of product availability entries. Each entry represents one product (SKU) with available inventory across the requested inventory lists.",
             "items": {
               "$ref": "#/components/schemas/Availability"
             }
           },
           "total": {
             "type": "integer",
-            "format": "int32"
+            "format": "int32",
+            "description": "The total number of distinct product entries in the data array, not individual inventory records.",
+            "example": 2
           }
         },
         "required": [
@@ -313,17 +383,25 @@
         "properties": {
           "title": {
             "type": "string",
+            "description": "A short, human-readable summary of the problem\ntype.  It will not change from occurrence to occurrence of the \nproblem, except for purposes of localization\n",
+            "example": "You do not have enough credit",
             "maxLength": 256
           },
           "type": {
             "type": "string",
+            "description": "A URI reference [RFC3986] that identifies the\nproblem type.  This specification encourages that, when\ndereferenced, it provide human-readable documentation for the\nproblem type (e.g., using HTML [W3C.REC-html5-20141028]).  When\nthis member is not present, its value is assumed to be\n\"about:blank\". It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "NotEnoughMoney",
             "maxLength": 2048
           },
           "detail": {
-            "type": "string"
+            "type": "string",
+            "description": "A human-readable explanation specific to this occurrence of the problem.",
+            "example": "Your current balance is 30, but that costs 50"
           },
           "instance": {
             "type": "string",
+            "description": "A URI reference that identifies the specific\noccurrence of the problem.  It may or may not yield further\ninformation if dereferenced.  It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "/account/12345/msgs/abc",
             "maxLength": 2048
           }
         },
@@ -341,6 +419,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "UnauthorizedExample": {
+                "$ref": "#/components/examples/UnauthorizedExample"
+              }
             }
           }
         }
@@ -350,21 +433,28 @@
       "organizationId": {
         "name": "organizationId",
         "in": "path",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "$ref": "#/components/schemas/OrganizationId"
-        }
+        },
+        "example": "f_ecom_zzxy_prd"
       },
       "productIds": {
         "name": "productIds",
         "in": "query",
+        "description": "The IDs of the requested products (comma-separated, max 24 IDs). If more than 24 IDs are required, split them into multiple parallel requests. Products that are offline or not found are silently filtered from the response.",
         "required": true,
         "style": "form",
         "explode": false,
         "schema": {
           "type": "array",
+          "example": [
+            "apple-ipod-shuffle",
+            "apple-ipod-nano"
+          ],
           "items": {
             "allOf": [
               {
@@ -374,16 +464,22 @@
           },
           "maxItems": 24,
           "minItems": 1
-        }
+        },
+        "example": "apple-ipod-shuffle,apple-ipod-nano"
       },
       "inventoryIds": {
         "name": "inventoryIds",
         "in": "query",
+        "description": "The inventory list IDs for which the availability should be shown (comma-separated, max 5 inventory list IDs). If omitted, availability is returned from the site-assigned default inventory list. If provided, availability is returned only from the specified inventory lists.",
         "required": false,
         "style": "form",
         "explode": false,
         "schema": {
           "type": "array",
+          "example": [
+            "Site1InventoryList",
+            "Site2InventoryList"
+          ],
           "items": {
             "allOf": [
               {
@@ -393,63 +489,66 @@
           },
           "maxItems": 5,
           "minItems": 1
-        }
+        },
+        "example": "Site1InventoryList,Site2InventoryList"
       },
       "siteId": {
         "name": "siteId",
         "in": "query",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
         "required": true,
         "style": "form",
         "explode": true,
         "schema": {
           "$ref": "#/components/schemas/SiteId"
+        },
+        "examples": {
+          "SiteId": {
+            "value": "RefArch"
+          }
         }
       },
       "expand": {
         "name": "expand",
         "in": "query",
+        "description": "Expand the response to include availability for related products. When `variations` is specified, availability for all variation products of a master product is included. When `set_products` is specified, availability for all products in a product set is included. The parent product's availability is always included alongside the expanded entries. Expansion is single-level only: if a variation is itself a product set, its set products are not further expanded. Other product types (bundles, bundled items, set items) are not expanded. Expanded results are returned flat at the top level of the response array, not nested below their parent product.\n**Note:** When using `expand=variations`, combine this response with variant data from the Shopper Products API to determine which specific variant attribute combinations (e.g. size=L, color=red) are orderable. Use the `productId` from each entry in the Shopper Products API `variants` array as the key to look up availability for that variant in this response.",
         "required": false,
         "style": "form",
         "explode": false,
         "schema": {
           "type": "array",
+          "example": [
+            "variations",
+            "set_products"
+          ],
           "items": {
             "type": "string",
             "enum": [
               "variations",
               "set_products"
-            ]
+            ],
+            "example": "variations"
           }
-        }
+        },
+        "example": "variations,set_products"
       },
       "sfdcUsid": {
         "name": "sfdc_usid",
         "in": "header",
+        "description": "A unique shopper identifier (USID) for tracking client context.\nUsed with endpoints secured with ShopperClientContextToken.\nThis header is required for all endpoints secured with ShopperClientContextToken.",
         "required": false,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
-          "format": "uuid"
-        }
-      },
-      "sfdcDwDnt": {
-        "name": "sfdc_dw_dnt",
-        "in": "header",
-        "required": false,
-        "style": "simple",
-        "explode": false,
-        "schema": {
-          "type": "string",
-          "enum": [
-            "0",
-            "1"
-          ]
+          "format": "uuid",
+          "example": "550e8400-e29b-41d4-a716-446655440000"
         }
       },
       "personalized": {
         "name": "personalized",
         "in": "query",
+        "description": "Controls whether personalization is applied to the response. When set to `none`, the server skips applying personalization to the response.",
         "required": false,
         "style": "form",
         "explode": true,
@@ -457,12 +556,14 @@
           "type": "string",
           "enum": [
             "none"
-          ]
+          ],
+          "example": "none"
         }
       },
       "sfdcShopperContext": {
         "name": "sfdc_shopper_context",
         "in": "header",
+        "description": "Shopper context information (for example clientIP, sourceCode, and customQualifiers)\npassed in from a trusted backend application.",
         "required": false,
         "style": "simple",
         "explode": false,
@@ -471,9 +572,121 @@
         }
       }
     },
+    "examples": {
+      "GetAvailabilityResponseExample": {
+        "value": {
+          "data": [
+            {
+              "id": "poodle-collar",
+              "inventories": [
+                {
+                  "ats": 100,
+                  "backorderable": false,
+                  "id": "site-default-inventory",
+                  "inStockDate": "2026-06-15T00:00:00.0Z",
+                  "orderable": true,
+                  "preorderable": false,
+                  "stockLevel": 90
+                }
+              ]
+            },
+            {
+              "id": "poodle-coat",
+              "inventories": [
+                {
+                  "id": "site-default-inventory"
+                }
+              ]
+            }
+          ],
+          "limit": 2,
+          "total": 2
+        }
+      },
+      "GetAvailabilityInventoryListsResponseExample": {
+        "value": {
+          "data": [
+            {
+              "id": "poodle-collar",
+              "inventories": [
+                {
+                  "ats": 100,
+                  "backorderable": false,
+                  "id": "inventory1",
+                  "orderable": true,
+                  "preorderable": false,
+                  "stockLevel": 90
+                },
+                {
+                  "ats": 5,
+                  "backorderable": false,
+                  "id": "inventory2",
+                  "orderable": true,
+                  "preorderable": true,
+                  "stockLevel": 5
+                }
+              ]
+            },
+            {
+              "id": "poodle-coat",
+              "inventories": [
+                {
+                  "ats": 7100,
+                  "backorderable": false,
+                  "id": "inventory1",
+                  "orderable": true,
+                  "preorderable": false,
+                  "stockLevel": 7090
+                },
+                {
+                  "ats": 15,
+                  "backorderable": false,
+                  "id": "inventory2",
+                  "orderable": true,
+                  "preorderable": true,
+                  "stockLevel": 15
+                }
+              ]
+            }
+          ],
+          "limit": 2,
+          "total": 2
+        }
+      },
+      "GetAvailabilityBadRequestResponseExample": {
+        "value": {
+          "title": "Bad Request",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/validation",
+          "detail": "Maximum number of product IDs you can request in one call is 24."
+        }
+      },
+      "GetAvailabilityInventoryListsBadRequestResponseExample": {
+        "value": {
+          "title": "Bad Request",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/validation",
+          "detail": "Maximum number of inventory list IDs you can request in one call is 5."
+        }
+      },
+      "MalformedSelectorResponseExample": {
+        "value": {
+          "title": "Malformed Selector",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/malformed-selector",
+          "detail": "The property selector '(data.(id, inventories.(**))' is malformed.",
+          "selector": "(data.(id, inventories.(**))"
+        }
+      },
+      "UnauthorizedExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/unauthorized",
+          "title": "Unauthorized",
+          "detail": "Unauthorized request"
+        }
+      }
+    },
     "securitySchemes": {
       "ShopperToken": {
         "type": "oauth2",
+        "description": "ShopperToken authentication follows the authorization code grant flow, as defined by the OAuth 2.1 standard. Depending on the type of OAuth client (public or private), this authorization flow has further requirements.\nFor a detailed description of the authorization flow, see the [SLAS overview](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-login:Summary).\nA shopper token allows you to access the Shopper API endpoints of both the Open Commerce API (OCAPI) and the B2C Commerce API. These endpoints can be used to build headless storefronts and other applications.\nThe `ShopperToken` security scheme is a parent of other security schemes, such as `ShopperTokenTsob`. A Shopper API endpoint can require a specific child scheme (`ShopperTokenTsob`, for example) that cannot be accessed with a regular shopper token.\n",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://{shortCode}.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/{organizationId}/oauth2/token",
@@ -494,6 +707,7 @@
       },
       "ShopperClientContextToken": {
         "type": "oauth2",
+        "description": "ShopperClientContextToken is a separate security scheme used to track and validate client context information.\nIt is valid for Guest shoppers flows only using SLAS private clients. For registered shoppers, use existing ShopperToken flows.\nFor authentication details, see the [SLAS overview](https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-login:Summary).\nThis token allows access to Shopper API endpoints for guest shoppers only.\n",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://{shortCode}.api.commercecloud.salesforce.com/shopper/auth/v1/organizations/{organizationId}/oauth2/token?hint=client_context",