@salesforce/b2c-tooling-sdk 2.4.0 → 2.5.0

package/node_modules/@salesforce/b2c-api-schemas/scapi/dx/scripts/v1.json

@@ -2,7 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Scripts",
-    "version": "1.0.0",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/scripts/scripts-oas-v1-public.yaml)\n\n# API Overview\n\nThe Scripts API provides endpoints for managing code versions on a Commerce Cloud instance.\n\n## Overview\n\nCode versions represent deployable bundles of cartridge code. This API allows administrators to list, create, read, update, and delete code versions on their Commerce Cloud instance.\n\n## Key Features\n\n- **List Code Versions**: Retrieve all code versions available on the instance\n- **Get Code Version**: Get detailed information about a specific code version\n- **Create Code Version**: Create or replace a code version using PUT\n- **Update Code Version**: Modify code version properties, such as activating a code version\n- **Delete Code Version**: Remove a code version (the active code version cannot be deleted)\n\n## Authentication\n\nThis API requires OAuth 2.0 authentication with the appropriate scopes:\n- `sfcc.scripts` - Read access to code version resources\n- `sfcc.scripts.rw` - Read and write access to code version resources\n\n## Best Practices\n\n1. Always verify which code version is active before making changes\n2. Use PATCH to update specific properties like activating a code version\n3. Avoid deleting the active code version - deactivate it first\n4. Use the GET list endpoint to discover available code versions before performing operations",
+    "version": "1.0.1",
     "x-api-type": "Admin",
     "x-api-family": "DX"
   },
@@ -11,6 +12,7 @@
       "url": "https://{shortCode}.api.commercecloud.salesforce.com/dx/scripts/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,31 +21,40 @@
   "paths": {
     "/organizations/{organizationId}/code-versions": {
       "get": {
+        "summary": "Get a list of code versions.",
+        "description": "Retrieves a list of all code versions available on the instance.",
         "operationId": "getCodeVersions",
         "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": "expand",
             "in": "query",
+            "description": "Specifies which related resources to include in the response.\nUse `size` to include the total size of the code version.\n",
             "required": false,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "size"
+              ],
               "items": {
                 "type": "string",
                 "enum": [
                   "size"
-                ]
+                ],
+                "example": "size"
               }
             }
           }
@@ -55,6 +66,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/CodeVersionResult"
+                },
+                "examples": {
+                  "CodeVersionListSuccess": {
+                    "$ref": "#/components/examples/CodeVersionListSuccess"
+                  }
                 }
               }
             }
@@ -78,26 +94,32 @@
     },
     "/organizations/{organizationId}/code-versions/{codeVersionId}": {
       "get": {
+        "summary": "Get a code version.",
+        "description": "Retrieves the details of a specific code version by its ID.",
         "operationId": "getCodeVersion",
         "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": "codeVersionId",
             "in": "path",
+            "description": "The ID of the code version.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "version1",
               "maxLength": 256,
               "minLength": 1
             }
@@ -105,16 +127,21 @@
           {
             "name": "expand",
             "in": "query",
+            "description": "Specifies which related resources to include in the response.\nUse `size` to include the total size of the code version.\n",
             "required": false,
             "style": "form",
             "explode": false,
             "schema": {
               "type": "array",
+              "example": [
+                "size"
+              ],
               "items": {
                 "type": "string",
                 "enum": [
                   "size"
-                ]
+                ],
+                "example": "size"
               }
             }
           }
@@ -126,6 +153,14 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/CodeVersion"
+                },
+                "examples": {
+                  "CodeVersionSuccess": {
+                    "$ref": "#/components/examples/CodeVersionSuccess"
+                  },
+                  "CodeVersionSuccessWithSize": {
+                    "$ref": "#/components/examples/CodeVersionSuccessWithSize"
+                  }
                 }
               }
             }
@@ -142,6 +177,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionIdNotFound": {
+                    "$ref": "#/components/examples/CodeVersionIdNotFound"
+                  }
                 }
               }
             }
@@ -157,26 +197,32 @@
         ]
       },
       "put": {
+        "summary": "Create or replace a code version.",
+        "description": "Creates a new code version or replaces an existing one with the given ID.",
         "operationId": "createCodeVersion",
         "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": "codeVersionId",
             "in": "path",
+            "description": "The ID of the code version.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "version1",
               "maxLength": 256,
               "minLength": 1
             }
@@ -189,6 +235,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/CodeVersion"
+                },
+                "examples": {
+                  "CodeVersionReplacedSuccess": {
+                    "$ref": "#/components/examples/CodeVersionReplacedSuccess"
+                  }
                 }
               }
             }
@@ -199,6 +250,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/CodeVersion"
+                },
+                "examples": {
+                  "CodeVersionCreatedSuccess": {
+                    "$ref": "#/components/examples/CodeVersionCreatedSuccess"
+                  }
                 }
               }
             }
@@ -215,6 +271,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionIdAlreadyExists": {
+                    "$ref": "#/components/examples/CodeVersionIdAlreadyExists"
+                  }
                 }
               }
             }
@@ -229,26 +290,32 @@
         ]
       },
       "delete": {
+        "summary": "Delete a code version.",
+        "description": "Deletes an existing code version by its ID. The active code version cannot be deleted.",
         "operationId": "deleteCodeVersion",
         "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": "codeVersionId",
             "in": "path",
+            "description": "The ID of the code version.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "version1",
               "maxLength": 256,
               "minLength": 1
             }
@@ -264,6 +331,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionModification": {
+                    "$ref": "#/components/examples/CodeVersionModification"
+                  }
                 }
               }
             }
@@ -280,6 +352,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionIdNotFound": {
+                    "$ref": "#/components/examples/CodeVersionIdNotFound"
+                  }
                 }
               }
             }
@@ -294,26 +371,32 @@
         ]
       },
       "patch": {
+        "summary": "Update a code version.",
+        "description": "Updates an existing code version with the provided properties. Use this endpoint to activate a code version.",
         "operationId": "updateCodeVersion",
         "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": "codeVersionId",
             "in": "path",
+            "description": "The ID of the code version.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "version1",
               "maxLength": 256,
               "minLength": 1
             }
@@ -324,6 +407,11 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/CodeVersion"
+              },
+              "examples": {
+                "ActivateCodeVersion": {
+                  "$ref": "#/components/examples/ActivateCodeVersion"
+                }
               }
             }
           },
@@ -336,6 +424,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/CodeVersion"
+                },
+                "examples": {
+                  "CodeVersionSuccess": {
+                    "$ref": "#/components/examples/CodeVersionSuccess"
+                  }
                 }
               }
             }
@@ -346,6 +439,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionModification": {
+                    "$ref": "#/components/examples/CodeVersionModification"
+                  }
                 }
               }
             }
@@ -362,6 +460,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionIdNotFound": {
+                    "$ref": "#/components/examples/CodeVersionIdNotFound"
+                  }
                 }
               }
             }
@@ -372,6 +475,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "CodeVersionIdAlreadyExists": {
+                    "$ref": "#/components/examples/CodeVersionIdAlreadyExists"
+                  }
                 }
               }
             }
@@ -391,21 +499,27 @@
     "schemas": {
       "OrganizationId": {
         "type": "string",
-        "maxLength": 32,
-        "minLength": 1
+        "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})$"
       },
       "Total": {
         "type": "integer",
         "format": "int32",
         "default": 0,
+        "description": "The total number of hits that match the search's criteria. This can be greater than the number of results returned as search results are pagenated.",
+        "example": 10,
         "minimum": 0
       },
       "ResultBase": {
         "type": "object",
+        "description": "Schema defining generic list result. Each response schema of a resource requiring a list response should extend this schema. \nAdditionally it needs to be defined what data is returned.",
         "properties": {
           "limit": {
             "type": "integer",
-            "format": "int32"
+            "format": "int32",
+            "description": "Maximum records to retrieve per request. The limit with its constraints (minimum, maximum, default) is defined by the request parameter `limit` of the endpoint returning this schema.",
+            "example": 10
           },
           "total": {
             "$ref": "#/components/schemas/Total"
@@ -418,43 +532,66 @@
       },
       "CodeVersion": {
         "type": "object",
+        "description": "A code version represents a deployable bundle of cartridge code on a Commerce Cloud instance.",
         "properties": {
           "id": {
             "type": "string",
+            "description": "The ID of the code version.",
+            "example": "version1",
             "maxLength": 256,
             "minLength": 1
           },
           "active": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Whether this is the active code version.",
+            "example": true
           },
           "cartridges": {
             "type": "array",
+            "description": "A list containing the names of all cartridges participating in this code version.",
+            "example": [
+              "app_storefront_base",
+              "app_storefront_controllers"
+            ],
             "items": {
               "type": "string",
+              "example": "app_storefront_base",
               "maxLength": 256
             }
           },
           "compatibilityMode": {
             "type": "string",
+            "description": "The compatibility mode for this code version.",
+            "example": "25.6",
             "maxLength": 100
           },
           "activationTime": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "The timestamp when this code version was activated.",
+            "example": "2025-01-15T10:00:00Z"
           },
           "lastModificationTime": {
             "type": "string",
-            "format": "date-time"
+            "format": "date-time",
+            "description": "The timestamp when this code version was last modified.",
+            "example": "2025-01-15T10:30:00Z"
           },
           "rollback": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Whether this code version supports rollback.",
+            "example": false
           },
           "totalSize": {
             "type": "integer",
-            "format": "int64"
+            "format": "int64",
+            "description": "The total size of the code version in bytes. Only included when `expand=size` is requested.",
+            "example": 104857600
           },
           "webDavUrl": {
             "type": "string",
+            "description": "The WebDAV URL for uploading code to this code version.",
+            "example": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1",
             "maxLength": 4000
           }
         }
@@ -465,9 +602,11 @@
             "$ref": "#/components/schemas/ResultBase"
           }
         ],
+        "description": "Result containing a list of code versions.",
         "properties": {
           "data": {
             "type": "array",
+            "description": "List of code versions.",
             "items": {
               "$ref": "#/components/schemas/CodeVersion"
             }
@@ -480,17 +619,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
           }
         },
@@ -508,6 +655,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "UnauthorizedExample": {
+                "$ref": "#/components/examples/UnauthorizedExample"
+              }
             }
           }
         }
@@ -518,6 +670,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "ForbiddenExample": {
+                "$ref": "#/components/examples/ForbiddenExample"
+              }
             }
           }
         }
@@ -527,45 +684,196 @@
       "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"
       },
       "expand": {
         "name": "expand",
         "in": "query",
+        "description": "Specifies which related resources to include in the response.\nUse `size` to include the total size of the code version.\n",
         "required": false,
         "style": "form",
         "explode": false,
         "schema": {
           "type": "array",
+          "example": [
+            "size"
+          ],
           "items": {
             "type": "string",
             "enum": [
               "size"
-            ]
+            ],
+            "example": "size"
           }
         }
       },
       "codeVersionId": {
         "name": "codeVersionId",
         "in": "path",
+        "description": "The ID of the code version.",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "version1",
           "maxLength": 256,
           "minLength": 1
         }
       }
     },
+    "examples": {
+      "CodeVersionListSuccess": {
+        "summary": "Successful code version list result",
+        "description": "Example of a successful response returning a list of all code versions on the instance.",
+        "value": {
+          "limit": 2,
+          "total": 2,
+          "data": [
+            {
+              "id": "version1",
+              "active": true,
+              "cartridges": [
+                "app_storefront_base",
+                "app_storefront_controllers"
+              ],
+              "compatibilityMode": "25.6",
+              "lastModificationTime": "2025-01-15T10:30:00.000Z",
+              "rollback": false,
+              "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1"
+            },
+            {
+              "id": "version2",
+              "active": false,
+              "cartridges": [
+                "app_storefront_base"
+              ],
+              "compatibilityMode": "25.6",
+              "lastModificationTime": "2025-01-10T08:00:00.000Z",
+              "rollback": true,
+              "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version2"
+            }
+          ]
+        }
+      },
+      "UnauthorizedExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/unauthorized",
+          "title": "Unauthorized",
+          "detail": "Unauthorized request"
+        }
+      },
+      "ForbiddenExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/forbidden",
+          "title": "Forbidden",
+          "detail": "Access to requested resource forbidden"
+        }
+      },
+      "CodeVersionSuccess": {
+        "summary": "Successful code version retrieval",
+        "description": "Example of a successful response returning a single code version with all properties.",
+        "value": {
+          "id": "version1",
+          "active": true,
+          "cartridges": [
+            "app_storefront_base",
+            "app_storefront_controllers"
+          ],
+          "compatibilityMode": "25.6",
+          "lastModificationTime": "2025-01-15T10:30:00.000Z",
+          "rollback": false,
+          "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1"
+        }
+      },
+      "CodeVersionSuccessWithSize": {
+        "summary": "Successful code version retrieval with size expanded",
+        "description": "Example of a successful response returning a single code version with the totalSize field included when `expand=size` is requested.",
+        "value": {
+          "id": "version1",
+          "active": true,
+          "cartridges": [
+            "app_storefront_base",
+            "app_storefront_controllers"
+          ],
+          "compatibilityMode": "25.6",
+          "lastModificationTime": "2025-01-15T10:30:00.000Z",
+          "rollback": false,
+          "totalSize": 104857600,
+          "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1"
+        }
+      },
+      "CodeVersionIdNotFound": {
+        "value": {
+          "title": "Code Version Id Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/code-version-id-not-found",
+          "detail": "The code version with ID 'nonexistent_version' couldn't be found."
+        }
+      },
+      "CodeVersionReplacedSuccess": {
+        "summary": "Successful code version replacement",
+        "description": "Example of a successful response when an existing code version is replaced via PUT.",
+        "value": {
+          "id": "version1",
+          "active": true,
+          "cartridges": [
+            "app_storefront_base",
+            "app_storefront_controllers"
+          ],
+          "compatibilityMode": "25.6",
+          "lastModificationTime": "2025-01-16T12:00:00.000Z",
+          "rollback": false,
+          "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/version1"
+        }
+      },
+      "CodeVersionCreatedSuccess": {
+        "summary": "Successful code version creation",
+        "description": "Example of a successful response when a new code version is created via PUT.",
+        "value": {
+          "id": "new_version",
+          "active": false,
+          "cartridges": [
+            "app_storefront_base"
+          ],
+          "compatibilityMode": "25.6",
+          "lastModificationTime": "2025-01-16T09:00:00.000Z",
+          "rollback": false,
+          "webDavUrl": "https://example.com/on/demandware.servlet/webdav/Sites/Cartridges/new_version"
+        }
+      },
+      "CodeVersionIdAlreadyExists": {
+        "value": {
+          "title": "Code Version Id Already Exists",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/code-version-id-already-exists",
+          "detail": "The code version ID 'version1' already exists."
+        }
+      },
+      "CodeVersionModification": {
+        "value": {
+          "title": "Code Version Modification",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/code-version-modification",
+          "detail": "The code version 'version1' is active and can't be changed."
+        }
+      },
+      "ActivateCodeVersion": {
+        "summary": "Activate a code version",
+        "description": "Example of activating a code version by setting active to true",
+        "value": {
+          "active": true
+        }
+      }
+    },
     "securitySchemes": {
       "AmOAuth2": {
         "type": "oauth2",
+        "description": "AccountManager OAuth 2.0 bearer token Authentication.",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
@@ -577,10 +885,8 @@
           "authorizationCode": {
             "authorizationUrl": "https://account.demandware.com/dwsso/oauth2/authorize",
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
-            "scopes": {
-              "sfcc.scripts": "Scripts API READONLY scope",
-              "sfcc.scripts.rw": "Scripts API scope"
-            }
+            "refreshUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
+            "scopes": {}
           }
         }
       }