@salesforce/b2c-tooling-sdk 2.4.0 → 2.5.0

package/node_modules/@salesforce/b2c-api-schemas/scapi/storefront/storefronts/v1.json

@@ -0,0 +1,1371 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Storefronts",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/storefront/storefronts-oas-v1-public.yaml)\n\n# API Overview\n\nThe Storefronts API provides B2C Commerce API (SCAPI)-native access to B2C storefront data for Storefront Next and PWA Kit. It replaces the Business Manager UI and partially data API setup flow. The B2C CLI and other tooling can use it for end-to-end automation. The Storefronts API provides full provisioning for Storefront Next and partial administration tasks for PWA Kit.\n\n- **Storefronts** — create, retrieve, list, update (site assignment), and delete storefronts at the organization level.\n\nStorefront creation and deletion are asynchronous: the API returns immediately with the resource in a non-terminal status, and callers poll the resource by ID to track progress. See the [Environments API](https://developer.salesforce.com/static/commercecloud/commerce-api/storefront/environments-oas-v1-public.yaml) for managing a storefront's environments.\n\n## Authentication & Authorization\n\nRequests are authenticated with Account Manager OAuth 2.0 bearer tokens (`AmOAuth2`). Access is governed by the Storefronts API scopes: `sfcc.storefront.storefronts` grants read-only access, and `sfcc.storefront.storefronts.rw` grants read and write access. Read operations (`GET`) accept either scope. Write operations (`POST`, `PATCH`, `DELETE`) require `sfcc.storefront.storefronts.rw`.\n\n## Idempotency\n\n- `POST /storefronts`: This operation is idempotent in effect but not in response code while the storefront record exists. The API rejects the requested storefrontName immediately if a record already exists with the same name, regardless of setup status. The retries don't create a second storefront or modify the existing one. The first call returns 202, and retries return 409 (StorefrontAlreadyExistsErrorResponse). After the storefront is fully deleted, its record is removed and the storefrontName becomes available for reuse. A subsequent POST with that name succeeds (202) instead of returning 409.\n- `PATCH /storefronts/{storefrontId}`: This operation is idempotent. The request body is the full desired `sites` list (complete replacement). Repeating an identical request produces the same resulting state.\n- `DELETE /storefronts/{storefrontId}`: This operation is idempotent in effect, but not in response code. The first call queues deletion (202). Once deletion completes, retrying returns 404. Deleting a storefront while a deletion of that same storefront is already in progress returns 409 (`StorefrontBusyErrorResponse`) rather than queuing a duplicate deletion.\n\n## Use Cases\n\n- Provision a Storefront Next storefront.\n- Assign or reassign existing sites to a storefront.\n- Poll storefront status during asynchronous provisioning or teardown.\n- Decommission a storefront.",
+    "version": "1.0.4",
+    "x-api-type": "Admin",
+    "x-api-family": "Storefront"
+  },
+  "servers": [
+    {
+      "url": "https://{shortCode}.api.commercecloud.salesforce.com/storefront/storefronts/v1",
+      "variables": {
+        "shortCode": {
+          "default": "123456gf"
+        }
+      }
+    }
+  ],
+  "paths": {
+    "/organizations/{organizationId}/storefronts": {
+      "get": {
+        "summary": "Get storefronts for an organization.",
+        "description": "Retrieves the list of storefronts provisioned for the organization, ordered by creationDate ascending.",
+        "operationId": "getStorefronts",
+        "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": "limit",
+            "in": "query",
+            "description": "Number of records to retrieve per request. Must be between 1 (minimum) and 200 (maximum). Defaults to 25.",
+            "required": false,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 25,
+              "maximum": 200,
+              "minimum": 1
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "description": "Used to retrieve the results based on a particular resource offset.",
+            "required": false,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32",
+              "default": 0,
+              "minimum": 0
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of storefronts successfully retrieved.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StorefrontResult"
+                },
+                "examples": {
+                  "StorefrontListSuccess": {
+                    "$ref": "#/components/examples/StorefrontListSuccess"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/401unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/403forbidden"
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.storefront.storefronts",
+              "sfcc.storefront.storefronts.rw"
+            ]
+          }
+        ]
+      },
+      "post": {
+        "summary": "Create a storefront.",
+        "description": "Queues creation of a new storefront. Returns immediately with the storefront resource in the in_progress setup status. Poll the storefront by ID to track provisioning progress.",
+        "operationId": "createStorefront",
+        "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"
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/StorefrontCreateRequest"
+              },
+              "examples": {
+                "CreateStorefront": {
+                  "$ref": "#/components/examples/CreateStorefront"
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "202": {
+            "description": "Storefront creation successfully queued.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Storefront"
+                },
+                "examples": {
+                  "StorefrontCreatedSuccess": {
+                    "$ref": "#/components/examples/StorefrontCreatedSuccess"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/400BadRequest_CreateStorefront"
+          },
+          "401": {
+            "$ref": "#/components/responses/401unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/403forbidden"
+          },
+          "409": {
+            "$ref": "#/components/responses/409Conflict_CreateStorefront"
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.storefront.storefronts.rw"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{organizationId}/storefronts/{storefrontId}": {
+      "get": {
+        "summary": "Get a storefront by ID.",
+        "description": "Retrieves the details of a specific storefront, including its current setup status and assigned sites.",
+        "operationId": "getStorefrontById",
+        "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": "storefrontId",
+            "in": "path",
+            "description": "The storefront identifier that B2C Commerce generates based on the provided storefront name. It consists of lowercase letters, numbers, and hyphens only, with no leading or trailing hyphens.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "example": "my-storefront-a1b2c3",
+              "maxLength": 20,
+              "minLength": 1,
+              "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Storefront successfully retrieved.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Storefront"
+                },
+                "examples": {
+                  "StorefrontSuccess": {
+                    "$ref": "#/components/examples/StorefrontSuccess"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/401unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/403forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/404NotFound_Storefront"
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.storefront.storefronts",
+              "sfcc.storefront.storefronts.rw"
+            ]
+          }
+        ]
+      },
+      "delete": {
+        "summary": "Delete a storefront.",
+        "description": "Queues deletion of the storefront. Returns immediately with the storefront resource in the delete_in_progress setup status. Poll the storefront by ID to track deletion progress.",
+        "operationId": "deleteStorefront",
+        "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": "storefrontId",
+            "in": "path",
+            "description": "The storefront identifier that B2C Commerce generates based on the provided storefront name. It consists of lowercase letters, numbers, and hyphens only, with no leading or trailing hyphens.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "example": "my-storefront-a1b2c3",
+              "maxLength": 20,
+              "minLength": 1,
+              "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+            }
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "Storefront deletion successfully queued.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Storefront"
+                },
+                "examples": {
+                  "StorefrontDeleteAcceptedSuccess": {
+                    "$ref": "#/components/examples/StorefrontDeleteAcceptedSuccess"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/401unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/403forbidden"
+          },
+          "404": {
+            "$ref": "#/components/responses/404NotFound_Storefront"
+          },
+          "409": {
+            "$ref": "#/components/responses/409Conflict_DeleteStorefront"
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.storefront.storefronts.rw"
+            ]
+          }
+        ]
+      },
+      "patch": {
+        "summary": "Update a storefront.",
+        "description": "Updates a storefront. Every field is optional and only the supplied fields are changed. When `sites` is provided it replaces the storefront's full set of assigned sites—a complete replacement, not an incremental update—so the request body must contain the complete desired set of site IDs. The `ssrRegion`, `ssrArchitecture`, `allowCookies`, and `preserveProxyUserAgent` fields update the storefront's default configuration.",
+        "operationId": "updateStorefront",
+        "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": "storefrontId",
+            "in": "path",
+            "description": "The storefront identifier that B2C Commerce generates based on the provided storefront name. It consists of lowercase letters, numbers, and hyphens only, with no leading or trailing hyphens.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "example": "my-storefront-a1b2c3",
+              "maxLength": 20,
+              "minLength": 1,
+              "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/StorefrontUpdateRequest"
+              },
+              "examples": {
+                "UpdateStorefront": {
+                  "$ref": "#/components/examples/UpdateStorefront"
+                },
+                "UpdateStorefrontConfiguration": {
+                  "$ref": "#/components/examples/UpdateStorefrontConfiguration"
+                }
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Storefront successfully updated.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Storefront"
+                },
+                "examples": {
+                  "StorefrontUpdatedSuccess": {
+                    "$ref": "#/components/examples/StorefrontUpdatedSuccess"
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "$ref": "#/components/responses/400BadRequest_UpdateStorefront"
+          },
+          "401": {
+            "$ref": "#/components/responses/401unauthorized"
+          },
+          "403": {
+            "$ref": "#/components/responses/403Forbidden_UpdateStorefront"
+          },
+          "404": {
+            "$ref": "#/components/responses/404NotFound_Storefront"
+          },
+          "409": {
+            "$ref": "#/components/responses/409Conflict_UpdateStorefront"
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.storefront.storefronts.rw"
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "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})$"
+      },
+      "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",
+            "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"
+          }
+        },
+        "required": [
+          "limit",
+          "total"
+        ]
+      },
+      "Offset": {
+        "type": "integer",
+        "format": "int32",
+        "default": 0,
+        "description": "The zero-based index of the first hit/data to include in the result.",
+        "example": 0,
+        "minimum": 0
+      },
+      "PaginatedResultBase": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ResultBase"
+          }
+        ],
+        "description": "Schema defining generic pageable result. Each response schema of a resource requiring pagination should extend this schema. \nIf you use this extend this schema directly, it needs to be defined what data is returned. Allowed names for the data field is `data`.",
+        "properties": {
+          "offset": {
+            "$ref": "#/components/schemas/Offset"
+          }
+        },
+        "required": [
+          "limit",
+          "offset",
+          "total"
+        ]
+      },
+      "StorefrontType": {
+        "type": "string",
+        "description": "The type of the storefront. `unknown` is a legacy fallback for existing records with no recorded type; it is never a valid value on create.",
+        "enum": [
+          "storefront_next",
+          "pwa_kit",
+          "headless",
+          "unknown"
+        ],
+        "example": "storefront_next"
+      },
+      "StorefrontSetupStatus": {
+        "type": "string",
+        "description": "The current provisioning/lifecycle status of the storefront.",
+        "enum": [
+          "in_progress",
+          "success",
+          "backfilled",
+          "failed",
+          "delete_in_progress",
+          "delete_failed",
+          "deleted",
+          "unknown"
+        ],
+        "example": "success"
+      },
+      "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
+      },
+      "SsrRegion": {
+        "type": "string",
+        "description": "The default AWS region for server-side rendering functions of environments newly created under this storefront. Each value corresponds to the AWS region of the same name with underscores substituted for hyphens (for example, `us_east_2` is the AWS region `us-east-2`).",
+        "enum": [
+          "us_east_1",
+          "us_east_2",
+          "us_west_1",
+          "us_west_2",
+          "ap_south_1",
+          "ap_south_2",
+          "ap_northeast_2",
+          "ap_southeast_1",
+          "ap_southeast_2",
+          "ap_southeast_3",
+          "ap_northeast_1",
+          "ap_northeast_3",
+          "ca_central_1",
+          "eu_central_1",
+          "eu_central_2",
+          "eu_west_1",
+          "eu_west_2",
+          "eu_west_3",
+          "eu_north_1",
+          "eu_south_1",
+          "sa_east_1"
+        ],
+        "example": "us_east_2"
+      },
+      "Storefront": {
+        "type": "object",
+        "description": "A storefront represents a provisioned Storefront Next or PWA Kit Composable storefront, its type, and the sites assigned to it.",
+        "properties": {
+          "storefrontId": {
+            "type": "string",
+            "description": "A storefront identifier that B2C Commerce generates based on the provided storefront name. The storefront ID is unique within the organization. It consists only of lowercase letters, numbers, and hyphens, with no leading or trailing hyphens.",
+            "example": "my-storefront-a1b2c3",
+            "maxLength": 20,
+            "minLength": 1,
+            "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+          },
+          "storefrontName": {
+            "type": "string",
+            "description": "The storefront name that you specify when creating a storefront. Must be 64 characters or fewer.",
+            "example": "my-storefront",
+            "maxLength": 64,
+            "minLength": 1
+          },
+          "type": {
+            "$ref": "#/components/schemas/StorefrontType"
+          },
+          "setupStatus": {
+            "$ref": "#/components/schemas/StorefrontSetupStatus"
+          },
+          "sites": {
+            "type": "array",
+            "description": "The IDs of the existing sites assigned to this storefront. By default a site can be assigned to only one storefront. Storefronts of type `pwa_kit` are exempt from this restriction and may share a site with another storefront.",
+            "example": [
+              "RefArch"
+            ],
+            "items": {
+              "$ref": "#/components/schemas/SiteId"
+            }
+          },
+          "creationDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The timestamp when the storefront was created.",
+            "example": "2026-04-08T21:47:28.188965Z"
+          },
+          "lastModified": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The timestamp when the storefront was last modified.",
+            "example": "2026-04-08T21:47:31.307595Z"
+          },
+          "ssrRegion": {
+            "$ref": "#/components/schemas/SsrRegion"
+          },
+          "ssrArchitecture": {
+            "type": "string",
+            "description": "The default architecture for the server-side rendering function of environments newly created under this storefront. Null when no architecture default is configured.",
+            "enum": [
+              "x86",
+              "arm64"
+            ],
+            "example": "arm64"
+          },
+          "allowCookies": {
+            "type": "boolean",
+            "description": "Whether cookies are allowed for the storefront. Always enabled for Storefront Next storefronts.",
+            "example": true
+          },
+          "preserveProxyUserAgent": {
+            "type": "boolean",
+            "description": "Whether the end-user's User-Agent header is preserved on requests forwarded through the storefront's configured proxies.",
+            "example": false
+          }
+        },
+        "required": [
+          "setupStatus",
+          "storefrontId",
+          "storefrontName",
+          "type"
+        ]
+      },
+      "StorefrontResult": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/PaginatedResultBase"
+          }
+        ],
+        "description": "Result containing a paginated list of storefronts.",
+        "properties": {
+          "data": {
+            "type": "array",
+            "description": "The list of storefronts. This field can be empty.",
+            "items": {
+              "$ref": "#/components/schemas/Storefront"
+            }
+          }
+        },
+        "required": [
+          "data"
+        ]
+      },
+      "ErrorResponse": {
+        "type": "object",
+        "additionalProperties": true,
+        "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",
+            "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
+          }
+        },
+        "required": [
+          "detail",
+          "title",
+          "type"
+        ]
+      },
+      "StorefrontCreateType": {
+        "type": "string",
+        "description": "The type of storefront to create. Only `storefront_next` is currently supported by the create-new-storefront flow.",
+        "enum": [
+          "storefront_next"
+        ],
+        "example": "storefront_next"
+      },
+      "StorefrontCreateRequest": {
+        "type": "object",
+        "description": "Request body for creating a storefront.",
+        "properties": {
+          "storefrontName": {
+            "type": "string",
+            "description": "The name to assign to the new storefront. Must be unique within the organization.",
+            "example": "my-storefront",
+            "maxLength": 64,
+            "minLength": 1
+          },
+          "type": {
+            "$ref": "#/components/schemas/StorefrontCreateType"
+          },
+          "sites": {
+            "type": "array",
+            "description": "The IDs of existing sites to assign to the storefront. At least one site is required.",
+            "example": [
+              "RefArch"
+            ],
+            "items": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "minItems": 1
+          }
+        },
+        "required": [
+          "sites",
+          "storefrontName",
+          "type"
+        ]
+      },
+      "InvalidStorefrontCreateRequestErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the storefront creation request body is malformed or missing required fields."
+      },
+      "StorefrontSiteNotFoundErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when a site in the storefront creation request does not exist.",
+        "properties": {
+          "siteId": {
+            "type": "string",
+            "description": "The identifier of the site that couldn't be found.",
+            "example": "RefArch",
+            "maxLength": 32,
+            "minLength": 1
+          }
+        }
+      },
+      "StorefrontAlreadyExistsErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when a storefront with the requested storefrontName already exists in the organization.",
+        "properties": {
+          "storefrontName": {
+            "type": "string",
+            "description": "The identifier that was already in use.",
+            "example": "my-storefront",
+            "maxLength": 64,
+            "minLength": 1
+          }
+        }
+      },
+      "StorefrontSiteCollisionErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when a site in the request is already assigned to a different storefront. Only storefronts of type pwa_kit are exempt from this restriction.",
+        "properties": {
+          "siteId": {
+            "type": "string",
+            "description": "The identifier of the site that is already assigned elsewhere.",
+            "example": "RefArch",
+            "maxLength": 32,
+            "minLength": 1
+          }
+        }
+      },
+      "StorefrontNotFoundErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the requested storefront does not exist for this organization.",
+        "properties": {
+          "storefrontId": {
+            "type": "string",
+            "description": "The identifier of the storefront that couldn't be found.",
+            "example": "my-storefront-a1b2c3",
+            "maxLength": 20,
+            "minLength": 1,
+            "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+          }
+        }
+      },
+      "StorefrontBusyErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when a storefront deletion cannot proceed because a deletion of this storefront is already in progress. Retry once the in-progress deletion completes.",
+        "properties": {
+          "storefrontId": {
+            "type": "string",
+            "description": "The identifier of the storefront whose deletion was requested.",
+            "example": "my-storefront-a1b2c3",
+            "maxLength": 20,
+            "minLength": 1,
+            "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+          }
+        }
+      },
+      "StorefrontUpdateRequest": {
+        "type": "object",
+        "description": "Request body for updating a storefront. Every field is optional and only the supplied fields are changed. When `sites` is provided it is a complete replacement of the storefront's site assignment, not an incremental update—supply the full set of site IDs.",
+        "properties": {
+          "sites": {
+            "type": "array",
+            "description": "The complete set of site IDs assigned to the storefront, replacing any previous assignment. When provided, at least one site is required.",
+            "example": [
+              "RefArch"
+            ],
+            "items": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "minItems": 1
+          },
+          "ssrRegion": {
+            "$ref": "#/components/schemas/SsrRegion"
+          },
+          "ssrArchitecture": {
+            "type": "string",
+            "description": "The default architecture for the server-side rendering function of environments newly created under this storefront. Set to null to clear the architecture default.",
+            "enum": [
+              "x86",
+              "arm64"
+            ],
+            "example": "arm64"
+          },
+          "allowCookies": {
+            "type": "boolean",
+            "description": "Whether cookies are allowed for the storefront. Cannot be modified for Storefront Next storefronts, where cookies are always enabled.",
+            "example": true
+          },
+          "preserveProxyUserAgent": {
+            "type": "boolean",
+            "description": "Whether the end-user's User-Agent header is preserved on requests forwarded through the storefront's configured proxies.",
+            "example": false
+          }
+        }
+      },
+      "InvalidStorefrontUpdateRequestErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the storefront update request body is malformed, contains an unsupported value (for example an invalid ssrRegion or ssrArchitecture), or supplies an empty sites list."
+      },
+      "StorefrontSsrRegionDisabledErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the requested ssrRegion is in the temporarily disabled set.",
+        "properties": {
+          "ssrRegion": {
+            "type": "string",
+            "description": "The identifier of the SSR region that is temporarily disabled.",
+            "example": "eu_south_1",
+            "maxLength": 32
+          }
+        }
+      },
+      "StorefrontSsrArchitectureNotEnabledErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the x86 ssrArchitecture is requested but the organization is not permitted to configure the SSR architecture."
+      },
+      "StorefrontSsrArchitectureX86EndOfLifeErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when the x86 ssrArchitecture is requested after its end-of-life date and the organization has no active grace period."
+      },
+      "StorefrontAllowCookiesBlockedErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when allowCookies is changed on a Storefront Next storefront, where cookies are always enabled."
+      },
+      "StorefrontInvalidStateForUpdateErrorResponse": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ErrorResponse"
+          }
+        ],
+        "description": "Returned when a site-assignment update is requested for a storefront whose setupStatus is not success.",
+        "properties": {
+          "storefrontId": {
+            "type": "string",
+            "description": "The identifier of the storefront that cannot be updated.",
+            "example": "my-storefront-a1b2c3",
+            "maxLength": 20,
+            "minLength": 1,
+            "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+          },
+          "setupStatus": {
+            "type": "string",
+            "description": "The storefront's current setup status, which is not success.",
+            "enum": [
+              "in_progress",
+              "backfilled",
+              "failed",
+              "delete_in_progress",
+              "delete_failed",
+              "deleted",
+              "unknown"
+            ],
+            "example": "in_progress"
+          }
+        }
+      }
+    },
+    "responses": {
+      "401unauthorized": {
+        "description": "Your access token is invalid or expired and can’t be used to identify a user.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "UnauthorizedExample": {
+                "$ref": "#/components/examples/UnauthorizedExample"
+              }
+            }
+          }
+        }
+      },
+      "403forbidden": {
+        "description": "Forbidden. Your access token is valid, but you don’t have the required permissions to access the resource.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "ForbiddenExample": {
+                "$ref": "#/components/examples/ForbiddenExample"
+              }
+            }
+          }
+        }
+      },
+      "400BadRequest_CreateStorefront": {
+        "description": "Bad Request. The storefront creation request body is invalid.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "oneOf": [
+                {
+                  "$ref": "#/components/schemas/InvalidStorefrontCreateRequestErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontSiteNotFoundErrorResponse"
+                }
+              ]
+            },
+            "examples": {
+              "InvalidStorefrontCreateRequestErrorResponseExample": {
+                "$ref": "#/components/examples/InvalidStorefrontCreateRequestErrorResponseExample"
+              },
+              "StorefrontSiteNotFoundErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSiteNotFoundErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "409Conflict_CreateStorefront": {
+        "description": "We couldn't create the storefront due to a conflict.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "oneOf": [
+                {
+                  "$ref": "#/components/schemas/StorefrontAlreadyExistsErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontSiteCollisionErrorResponse"
+                }
+              ]
+            },
+            "examples": {
+              "StorefrontAlreadyExistsErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontAlreadyExistsErrorResponseExample"
+              },
+              "StorefrontSiteCollisionErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSiteCollisionErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "404NotFound_Storefront": {
+        "description": "We couldn't find the requested storefront.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "$ref": "#/components/schemas/StorefrontNotFoundErrorResponse"
+            },
+            "examples": {
+              "StorefrontNotFoundErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontNotFoundErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "409Conflict_DeleteStorefront": {
+        "description": "We couldn't delete the storefront because a deletion of this storefront is already in progress.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "$ref": "#/components/schemas/StorefrontBusyErrorResponse"
+            },
+            "examples": {
+              "StorefrontBusyErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontBusyErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "400BadRequest_UpdateStorefront": {
+        "description": "Bad Request. The storefront update request body is invalid.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "oneOf": [
+                {
+                  "$ref": "#/components/schemas/InvalidStorefrontUpdateRequestErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontSsrRegionDisabledErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontSsrArchitectureNotEnabledErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontSsrArchitectureX86EndOfLifeErrorResponse"
+                }
+              ]
+            },
+            "examples": {
+              "InvalidStorefrontUpdateRequestErrorResponseExample": {
+                "$ref": "#/components/examples/InvalidStorefrontUpdateRequestErrorResponseExample"
+              },
+              "StorefrontSsrRegionDisabledErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSsrRegionDisabledErrorResponseExample"
+              },
+              "StorefrontSsrArchitectureNotEnabledErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSsrArchitectureNotEnabledErrorResponseExample"
+              },
+              "StorefrontSsrArchitectureX86EndOfLifeErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSsrArchitectureX86EndOfLifeErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "403Forbidden_UpdateStorefront": {
+        "description": "Forbidden. The requested storefront update is not permitted.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "$ref": "#/components/schemas/StorefrontAllowCookiesBlockedErrorResponse"
+            },
+            "examples": {
+              "StorefrontAllowCookiesBlockedErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontAllowCookiesBlockedErrorResponseExample"
+              }
+            }
+          }
+        }
+      },
+      "409Conflict_UpdateStorefront": {
+        "description": "We couldn't update the storefront's site assignment due to a conflict.",
+        "content": {
+          "application/problem+json": {
+            "schema": {
+              "oneOf": [
+                {
+                  "$ref": "#/components/schemas/StorefrontSiteCollisionErrorResponse"
+                },
+                {
+                  "$ref": "#/components/schemas/StorefrontInvalidStateForUpdateErrorResponse"
+                }
+              ]
+            },
+            "examples": {
+              "StorefrontSiteCollisionErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontSiteCollisionErrorResponseExample"
+              },
+              "StorefrontInvalidStateForUpdateErrorResponseExample": {
+                "$ref": "#/components/examples/StorefrontInvalidStateForUpdateErrorResponseExample"
+              }
+            }
+          }
+        }
+      }
+    },
+    "parameters": {
+      "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"
+      },
+      "storefrontId": {
+        "name": "storefrontId",
+        "in": "path",
+        "description": "The storefront identifier that B2C Commerce generates based on the provided storefront name. It consists of lowercase letters, numbers, and hyphens only, with no leading or trailing hyphens.",
+        "required": true,
+        "style": "simple",
+        "explode": false,
+        "schema": {
+          "type": "string",
+          "example": "my-storefront-a1b2c3",
+          "maxLength": 20,
+          "minLength": 1,
+          "pattern": "^[a-z0-9]+(?:-+[a-z0-9]+)*$"
+        }
+      }
+    },
+    "examples": {
+      "StorefrontListSuccess": {
+        "summary": "Successful storefront list result",
+        "description": "Example of a successful response returning the list of storefronts for an organization.",
+        "value": {
+          "limit": 25,
+          "offset": 0,
+          "total": 2,
+          "data": [
+            {
+              "storefrontId": "market-street-a1b2c3",
+              "storefrontName": "MarketStreet",
+              "type": "storefront_next",
+              "setupStatus": "success",
+              "sites": [
+                "MarketStreet"
+              ],
+              "creationDate": "2026-04-08T21:47:28.188965Z",
+              "lastModified": "2026-04-08T21:47:31.307595Z"
+            },
+            {
+              "storefrontId": "beauty-street-d4e5f6",
+              "storefrontName": "BeautyStreet",
+              "type": "pwa_kit",
+              "setupStatus": "in_progress",
+              "sites": [
+                "BeautyStreet"
+              ],
+              "creationDate": "2026-04-09T10:12:00.000000Z",
+              "lastModified": "2026-04-09T10:12:00.000000Z"
+            }
+          ]
+        }
+      },
+      "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"
+        }
+      },
+      "CreateStorefront": {
+        "summary": "Create a storefront",
+        "description": "Create a storefront with an initial site assignment.",
+        "value": {
+          "storefrontName": "MarketStreet",
+          "type": "storefront_next",
+          "sites": [
+            "MarketStreet"
+          ]
+        }
+      },
+      "StorefrontCreatedSuccess": {
+        "summary": "Successful storefront creation",
+        "description": "Example of a successful response when a new storefront is queued for creation (202 Accepted).",
+        "value": {
+          "storefrontId": "market-street-a1b2c3",
+          "storefrontName": "MarketStreet",
+          "type": "storefront_next",
+          "setupStatus": "in_progress",
+          "sites": [
+            "MarketStreet"
+          ],
+          "creationDate": "2026-04-08T21:47:28.188965Z",
+          "lastModified": "2026-04-08T21:47:28.188965Z"
+        }
+      },
+      "StorefrontSuccess": {
+        "summary": "Successful storefront retrieval",
+        "description": "Example of a successful response returning a single storefront.",
+        "value": {
+          "storefrontId": "market-street-a1b2c3",
+          "storefrontName": "MarketStreet",
+          "type": "storefront_next",
+          "setupStatus": "success",
+          "sites": [
+            "MarketStreet"
+          ],
+          "creationDate": "2026-04-08T21:47:28.188965Z",
+          "lastModified": "2026-04-08T21:47:31.307595Z"
+        }
+      },
+      "StorefrontDeleteAcceptedSuccess": {
+        "summary": "Successful storefront deletion request",
+        "description": "Example of a successful response when a storefront is queued for deletion (202 Accepted).",
+        "value": {
+          "storefrontId": "market-street-a1b2c3",
+          "storefrontName": "MarketStreet",
+          "type": "storefront_next",
+          "setupStatus": "delete_in_progress",
+          "sites": [
+            "MarketStreet"
+          ],
+          "creationDate": "2026-04-08T21:47:28.188965Z",
+          "lastModified": "2026-04-09T09:30:00.000000Z"
+        }
+      },
+      "UpdateStorefront": {
+        "summary": "Replace a storefront's site assignment",
+        "description": "Replace the full set of sites assigned to a storefront.",
+        "value": {
+          "sites": [
+            "MarketStreet",
+            "BeautyStreet"
+          ]
+        }
+      },
+      "UpdateStorefrontConfiguration": {
+        "summary": "Update a storefront's default configuration",
+        "description": "Update the storefront's default SSR and proxy configuration without changing its site assignment. Every field is optional.",
+        "value": {
+          "ssrRegion": "us_east_2",
+          "ssrArchitecture": "arm64",
+          "allowCookies": true,
+          "preserveProxyUserAgent": false
+        }
+      },
+      "StorefrontUpdatedSuccess": {
+        "summary": "Successful storefront site-assignment update",
+        "description": "Example of a successful response after replacing a storefront's site assignment.",
+        "value": {
+          "storefrontId": "market-street-a1b2c3",
+          "storefrontName": "MarketStreet",
+          "type": "storefront_next",
+          "setupStatus": "success",
+          "sites": [
+            "MarketStreet",
+            "BeautyStreet"
+          ],
+          "creationDate": "2026-04-08T21:47:28.188965Z",
+          "lastModified": "2026-04-09T09:00:00.000000Z"
+        }
+      },
+      "InvalidStorefrontCreateRequestErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/invalid-storefront-create-request",
+          "detail": "The storefront creation request body is invalid. A valid storefrontName, type, and sites are required.",
+          "title": "Invalid Storefront Create Request"
+        }
+      },
+      "StorefrontSiteNotFoundErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-site-not-found",
+          "detail": "We couldn't find site RefArch.",
+          "title": "Storefront Site Not Found"
+        }
+      },
+      "StorefrontAlreadyExistsErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-already-exists",
+          "detail": "A storefront with ID 'my-storefront' already exists.",
+          "title": "Storefront Already Exists"
+        }
+      },
+      "StorefrontSiteCollisionErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-site-collision",
+          "detail": "Site 'RefArch' is already assigned to another storefront.",
+          "title": "Storefront Site Collision"
+        }
+      },
+      "StorefrontNotFoundErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-not-found",
+          "detail": "We couldn't find storefront my-storefront-a1b2c3.",
+          "title": "Storefront Not Found"
+        }
+      },
+      "StorefrontBusyErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-busy",
+          "detail": "There is an ongoing deletion for storefront 'my-storefront-a1b2c3'.",
+          "title": "Storefront Busy"
+        }
+      },
+      "InvalidStorefrontUpdateRequestErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/invalid-storefront-update-request",
+          "detail": "The storefront update request body is invalid.",
+          "title": "Invalid Storefront Update Request"
+        }
+      },
+      "StorefrontSsrRegionDisabledErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-ssr-region-disabled",
+          "detail": "SSR region 'eu_south_1' is temporarily disabled. Choose a different region.",
+          "title": "Storefront Ssr Region Disabled"
+        }
+      },
+      "StorefrontSsrArchitectureNotEnabledErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-ssr-architecture-not-enabled",
+          "detail": "The Server-Side Rendering architecture configuration isn't enabled for this organization.",
+          "title": "Storefront Ssr Architecture Not Enabled"
+        }
+      },
+      "StorefrontSsrArchitectureX86EndOfLifeErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-ssr-architecture-x86-end-of-life",
+          "detail": "x86 is past end-of-life and can no longer be selected. Use arm64.",
+          "title": "Storefront Ssr Architecture X86 End Of Life"
+        }
+      },
+      "StorefrontAllowCookiesBlockedErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-allow-cookies-blocked",
+          "detail": "You can't modify Allow Cookies for Storefront Next. Cookies are always enabled.",
+          "title": "Storefront Allow Cookies Blocked"
+        }
+      },
+      "StorefrontInvalidStateForUpdateErrorResponseExample": {
+        "value": {
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/storefront-invalid-state-for-update",
+          "detail": "Storefront 'my-storefront-a1b2c3' can't be updated while its setup status is 'in_progress'.",
+          "title": "Storefront Invalid State For Update"
+        }
+      }
+    },
+    "securitySchemes": {
+      "AmOAuth2": {
+        "type": "oauth2",
+        "description": "AccountManager OAuth 2.0 bearer token Authentication.",
+        "flows": {
+          "clientCredentials": {
+            "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
+            "scopes": {
+              "sfcc.storefront.storefronts": "Read-only access to the Storefronts API.",
+              "sfcc.storefront.storefronts.rw": "Read and write access to the Storefronts API."
+            }
+          }
+        }
+      }
+    }
+  }
+}