@salesforce/b2c-tooling-sdk 2.4.0 → 2.5.0

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

@@ -2,7 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Object Definitions",
-    "version": "1.1.2",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/object-definitions/object-definitions-oas-v1-public.yaml)\n\n# API Overview\n\nUse the Object Definitions API to search for and manage attribute definitions\nfor object types in B2C Commerce. Discover and\ninspect the metadata structure of objects such as Product, Customer, and Order.\n\nUse this API to:\n- Search attribute definitions with complex queries\n- Filter by attribute properties (type, searchability, visibility, etc.)\n- Retrieve detailed metadata about attribute definitions\n- Discover available values for enum-type attributes\n\n## Authentication & Authorization\n\nThe Object Definitions API requires valid authentication and authorization to be accessed. It uses an Account Manager OAuth 2.0 bearer token for authentication. \n\nThe necessary scope for accessing the Object Definitions API is:\n\n* `sfcc.object-definitions.rw`: Provides read-write access.\n\nYou must include the relevant scope in the client ID used to generate the token. For details, see [Authorization Scopes Catalog](https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html).\n\n## Response Details\n\n### Timeouts\n\nAdmin API requests must respond within 60 seconds. If a response exceeds this threshold, an HTTP 504 status code is returned. For details, see [Timeouts and Limits.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/timeouts-limits.html)\n\n### Error Handling\n\nError responses follow the [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) problem detail format. To trace errors, include a `correlation-id` header in your request — the response returns it as `x-correlation-id`. For details, see [HTTP Status Codes and Errors.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/error-response-codes.html)",
+    "version": "1.1.3",
     "x-api-type": "Admin",
     "x-api-family": "DX"
   },
@@ -11,6 +12,7 @@
       "url": "https://{shortCode}.api.commercecloud.salesforce.com/dx/object-definitions/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,17 +21,21 @@
   "paths": {
     "/organizations/{organizationId}/system/object-types": {
       "get": {
+        "summary": "Get system object types",
+        "description": "Retrieves a paginated list of all system object type definitions.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse `offset` and `limit` for pagination.\n",
         "operationId": "getSystemObjectTypes",
         "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": "select",
@@ -39,11 +45,17 @@
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/Select"
+            },
+            "examples": {
+              "select": {
+                "value": "(**)"
+              }
             }
           },
           {
             "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,
@@ -58,6 +70,7 @@
           {
             "name": "offset",
             "in": "query",
+            "description": "Used to retrieve the results based on a particular resource offset.",
             "required": false,
             "style": "form",
             "explode": true,
@@ -76,6 +89,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectTypeDefinitionResult"
+                },
+                "examples": {
+                  "SystemObjectTypeResultExample": {
+                    "$ref": "#/components/examples/SystemObjectTypeResultExample"
+                  }
                 }
               }
             }
@@ -92,6 +110,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -109,24 +132,34 @@
     },
     "/organizations/{organizationId}/system/object-types-search": {
       "post": {
+        "summary": "Search system object types",
+        "description": "Searches system object type definitions based on the provided query criteria.\n\n**Searchable fields:**\n- objectType (String)\n- display_name* (Localized String)\n- description* (Localized String)\n- read_only (boolean)\n\n**Sortable fields:**\n- objectType\n- display_name\n- description\n- read_only\n\n*Note: Localized fields are searched across all locales.\n",
         "operationId": "searchSystemObjectTypes",
         "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": {
+          "description": "The search request for system object types",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SearchRequest"
+              },
+              "examples": {
+                "SearchSystemObjectTypes": {
+                  "$ref": "#/components/examples/SearchSystemObjectTypes"
+                }
               }
             }
           },
@@ -139,6 +172,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectTypeDefinitionSearchResult"
+                },
+                "examples": {
+                  "SystemObjectTypeSearchResultExample": {
+                    "$ref": "#/components/examples/SystemObjectTypeSearchResultExample"
+                  }
                 }
               }
             }
@@ -149,6 +187,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "FieldNotSortableExample": {
+                    "$ref": "#/components/examples/FieldNotSortableExample"
+                  }
                 }
               }
             }
@@ -172,26 +215,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}": {
       "get": {
+        "summary": "Get system object type",
+        "description": "Retrieves a single system object type definition by its identifier.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse the `expand` parameter to include related resources.\n",
         "operationId": "getSystemObjectType",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -204,6 +253,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectTypeDefinition"
+                },
+                "examples": {
+                  "SystemObjectTypeExample": {
+                    "$ref": "#/components/examples/SystemObjectTypeExample"
+                  }
                 }
               }
             }
@@ -220,6 +274,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -237,36 +296,51 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-definition-search": {
       "post": {
+        "summary": "Search attribute definitions for system object",
+        "description": "Searches the attribute definitions of the specified system object type.\n\nThe query attribute specifies a complex query that can be used to narrow down the search. \nAttributes are grouped into different buckets:\n\n**Main bucket:**\n- id (String)\n- display_name* (Localized String)\n- description* (Localized String)\n- key (boolean)\n- mandatory (boolean)\n- searchable (boolean)\n- system (boolean)\n- visible (boolean)\n\n**Definition version bucket:**\n- localizable (boolean)\n- site_specific (boolean)\n- value_type (enum)\n\n**Group bucket:**\n- group (String)\n\n*Note: These attributes are not searchable or sortable for built-in system attributes. \nThey work normally for non-system attributes.\n\nOnly attributes in the same bucket can be joined using a disjunction (OR). \nFor instance, when joining localizable and description, only a conjunction is allowed (AND).\n",
         "operationId": "searchAttributeDefinitionForSystemObject",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The search request for attribute definitions",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SearchRequest"
+              },
+              "examples": {
+                "SearchByValueType": {
+                  "$ref": "#/components/examples/SearchByValueType"
+                },
+                "SearchWithSorting": {
+                  "$ref": "#/components/examples/SearchWithSorting"
+                }
               }
             }
           },
@@ -279,6 +353,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinitionSearchResult"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionSearchResultExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionSearchResultExample"
+                  }
                 }
               }
             }
@@ -289,6 +368,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "FieldNotSortableExample": {
+                    "$ref": "#/components/examples/FieldNotSortableExample"
+                  }
                 }
               }
             }
@@ -305,6 +389,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -321,36 +410,51 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-group-search": {
       "post": {
+        "summary": "Search attribute groups for system object",
+        "description": "Searches the attribute groups of the specified system object type.\n\n**Searchable fields:**\n- id (String)\n- display_name (Localized String)\n- description (Localized String)\n- internal (boolean)\n- position (number)\n\n**Sortable fields:**\n- id\n- display_name\n- description\n- internal\n- position\n",
         "operationId": "searchAttributeGroupsForSystemObject",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The search request for attribute groups",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/SearchRequest"
+              },
+              "examples": {
+                "SearchAttributeGroups": {
+                  "$ref": "#/components/examples/SearchAttributeGroups"
+                },
+                "SearchAttributeGroupsByDisplayName": {
+                  "$ref": "#/components/examples/SearchAttributeGroupsByDisplayName"
+                }
               }
             }
           },
@@ -363,6 +467,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroupSearchResult"
+                },
+                "examples": {
+                  "ObjectAttributeGroupSearchResultExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupSearchResultExample"
+                  }
                 }
               }
             }
@@ -373,6 +482,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "MalformedSearchParameterExample": {
+                    "$ref": "#/components/examples/FieldNotSortableExample"
+                  }
                 }
               }
             }
@@ -389,6 +503,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -405,26 +524,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-groups": {
       "get": {
+        "summary": "Get attribute groups",
+        "description": "Retrieves a paginated list of attribute groups for the specified system object type.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse the `expand` parameter with value `definition` to include attribute definitions.\nUse `offset` and `limit` for pagination.\n",
         "operationId": "getAttributeGroups",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -437,22 +562,30 @@
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/Select"
+            },
+            "examples": {
+              "select": {
+                "value": "(**)"
+              }
             }
           },
           {
             "name": "expand",
             "in": "query",
+            "description": "Specifies which related resources to include in the response.\nFor attribute groups, use `definition` to include attribute definitions.\n",
             "required": false,
             "style": "form",
             "explode": true,
             "schema": {
               "type": "string",
+              "example": "definition",
               "maxLength": 256
             }
           },
           {
             "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,
@@ -467,6 +600,7 @@
           {
             "name": "offset",
             "in": "query",
+            "description": "Used to retrieve the results based on a particular resource offset.",
             "required": false,
             "style": "form",
             "explode": true,
@@ -485,6 +619,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroupResult"
+                },
+                "examples": {
+                  "ObjectAttributeGroupResultExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupResultExample"
+                  }
                 }
               }
             }
@@ -501,6 +640,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -518,26 +662,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-groups/{id}": {
       "get": {
+        "summary": "Get attribute group",
+        "description": "Retrieves a single attribute group by its identifier.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse the `expand` parameter with value `definition` to include attribute definitions.\n",
         "operationId": "getAttributeGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -545,11 +695,13 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
@@ -562,16 +714,23 @@
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/Select"
+            },
+            "examples": {
+              "select": {
+                "value": "(**)"
+              }
             }
           },
           {
             "name": "expand",
             "in": "query",
+            "description": "Specifies which related resources to include in the response.\nFor attribute groups, use `definition` to include attribute definitions.\n",
             "required": false,
             "style": "form",
             "explode": true,
             "schema": {
               "type": "string",
+              "example": "definition",
               "maxLength": 256
             }
           }
@@ -583,6 +742,14 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroup"
+                },
+                "examples": {
+                  "ObjectAttributeGroupExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupExample"
+                  },
+                  "ObjectAttributeGroupWithDefinitionsExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupWithDefinitionsExample"
+                  }
                 }
               }
             }
@@ -599,6 +766,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeGroupNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeGroupNotFoundExample"
+                  }
                 }
               }
             }
@@ -614,26 +786,32 @@
         ]
       },
       "put": {
+        "summary": "Create or replace attribute group",
+        "description": "Creates a new attribute group or replaces an existing one with the specified identifier.\n\nReturns 201 if a new attribute group was created, or 200 if an existing one was replaced.\n",
         "operationId": "createOrReplaceAttributeGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -641,21 +819,32 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The attribute group data",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/ObjectAttributeGroup"
+              },
+              "examples": {
+                "CreateAttributeGroup": {
+                  "$ref": "#/components/examples/CreateAttributeGroup"
+                },
+                "CreateAttributeGroupWithInternal": {
+                  "$ref": "#/components/examples/CreateAttributeGroupWithInternal"
+                }
               }
             }
           },
@@ -668,6 +857,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroup"
+                },
+                "examples": {
+                  "ObjectAttributeGroupExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupExample"
+                  }
                 }
               }
             }
@@ -678,6 +872,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroup"
+                },
+                "examples": {
+                  "ObjectAttributeGroupCreatedExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupCreatedExample"
+                  }
                 }
               }
             }
@@ -688,6 +887,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "IdConflictExample": {
+                    "$ref": "#/components/examples/IdConflictExample"
+                  }
                 }
               }
             }
@@ -704,6 +908,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -718,26 +927,32 @@
         ]
       },
       "delete": {
+        "summary": "Delete attribute group",
+        "description": "Deletes an attribute group by its identifier.\n\nThis operation cannot be undone. All attribute definitions will be unassigned from the group\nbut will not be deleted.\n",
         "operationId": "deleteAttributeGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -745,11 +960,13 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
@@ -771,6 +988,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeGroupNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeGroupNotFoundExample"
+                  }
                 }
               }
             }
@@ -785,26 +1007,32 @@
         ]
       },
       "patch": {
+        "summary": "Update attribute group",
+        "description": "Partially updates an existing attribute group.\n\nOnly the properties provided in the request body will be updated.\n",
         "operationId": "updateAttributeGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -812,21 +1040,32 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The attribute group data to update",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/ObjectAttributeGroup"
+              },
+              "examples": {
+                "UpdateAttributeGroup": {
+                  "$ref": "#/components/examples/UpdateAttributeGroup"
+                },
+                "UpdateAttributeGroupPosition": {
+                  "$ref": "#/components/examples/UpdateAttributeGroupPosition"
+                }
               }
             }
           },
@@ -839,6 +1078,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeGroup"
+                },
+                "examples": {
+                  "ObjectAttributeGroupExample": {
+                    "$ref": "#/components/examples/ObjectAttributeGroupExample"
+                  }
                 }
               }
             }
@@ -849,6 +1093,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "MalformedRequestBodyExample": {
+                    "$ref": "#/components/examples/MalformedRequestBodyExample"
+                  }
                 }
               }
             }
@@ -865,6 +1114,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeGroupNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeGroupNotFoundExample"
+                  }
                 }
               }
             }
@@ -881,26 +1135,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-groups/{groupId}/attribute-definitions/{defId}": {
       "put": {
+        "summary": "Assign attribute definition to group",
+        "description": "Assigns an attribute definition to an attribute group.\n\nThe attribute definition must exist for the specified system object type.\nAn attribute definition can be assigned to multiple groups.\n",
         "operationId": "assignAttributeDefinitionToGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -908,11 +1168,13 @@
           {
             "name": "groupId",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
@@ -920,11 +1182,13 @@
           {
             "name": "defId",
             "in": "path",
+            "description": "The unique identifier of the attribute definition to assign or unassign.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
@@ -946,6 +1210,17 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  },
+                  "AttributeGroupNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeGroupNotFoundExample"
+                  },
+                  "AttributeDefinitionNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeDefinitionNotFoundExample"
+                  }
                 }
               }
             }
@@ -960,26 +1235,32 @@
         ]
       },
       "delete": {
+        "summary": "Unassign attribute definition from group",
+        "description": "Removes an attribute definition from an attribute group.\n\nThis operation only removes the assignment; the attribute definition itself is not deleted.\n",
         "operationId": "unassignAttributeDefinitionFromGroup",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -987,11 +1268,13 @@
           {
             "name": "groupId",
             "in": "path",
+            "description": "The unique identifier of the attribute group.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "custom-attributes",
               "maxLength": 256,
               "minLength": 1
             }
@@ -999,11 +1282,13 @@
           {
             "name": "defId",
             "in": "path",
+            "description": "The unique identifier of the attribute definition to assign or unassign.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1025,6 +1310,17 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  },
+                  "AttributeGroupNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeGroupNotFoundExample"
+                  },
+                  "AttributeDefinitionNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeDefinitionNotFoundExample"
+                  }
                 }
               }
             }
@@ -1041,26 +1337,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-definitions": {
       "get": {
+        "summary": "Get attribute definitions",
+        "description": "Retrieves a paginated list of attribute definitions for the specified system object type.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse `offset` and `limit` for pagination.\n",
         "operationId": "getAttributeDefinitions",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1073,11 +1375,17 @@
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/Select"
+            },
+            "examples": {
+              "select": {
+                "value": "(**)"
+              }
             }
           },
           {
             "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,
@@ -1092,6 +1400,7 @@
           {
             "name": "offset",
             "in": "query",
+            "description": "Used to retrieve the results based on a particular resource offset.",
             "required": false,
             "style": "form",
             "explode": true,
@@ -1110,6 +1419,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinitionResult"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionResultExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionResultExample"
+                  }
                 }
               }
             }
@@ -1126,6 +1440,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -1143,26 +1462,32 @@
     },
     "/organizations/{organizationId}/system/object-types/{objectType}/attribute-definitions/{id}": {
       "get": {
+        "summary": "Get attribute definition",
+        "description": "Retrieves a single attribute definition by its identifier.\n\nUse the `select` parameter to specify which properties to include in the response.\nUse the `expand` parameter to include related resources.\n",
         "operationId": "getAttributeDefinition",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1170,11 +1495,13 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute definition.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1187,16 +1514,23 @@
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/Select"
+            },
+            "examples": {
+              "select": {
+                "value": "(**)"
+              }
             }
           },
           {
             "name": "expand",
             "in": "query",
+            "description": "Specifies which related resources to include in the response.\nFor attribute groups, use `definition` to include attribute definitions.\n",
             "required": false,
             "style": "form",
             "explode": true,
             "schema": {
               "type": "string",
+              "example": "definition",
               "maxLength": 256
             }
           }
@@ -1208,6 +1542,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinition"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionExample"
+                  }
                 }
               }
             }
@@ -1224,6 +1563,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeDefinitionNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeDefinitionNotFoundExample"
+                  }
                 }
               }
             }
@@ -1239,26 +1583,32 @@
         ]
       },
       "put": {
+        "summary": "Create or replace attribute definition",
+        "description": "Creates a new attribute definition or replaces an existing one with the specified identifier.\n\nReturns 201 if a new attribute definition was created, or 200 if an existing one was replaced.\n\n**Important:** The `valueType` property is required when creating a new attribute definition\nand cannot be changed after creation.\n",
         "operationId": "createOrReplaceAttributeDefinition",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1266,21 +1616,38 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute definition.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The attribute definition data",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/ObjectAttributeDefinition"
+              },
+              "examples": {
+                "CreateAttributeDefinitionString": {
+                  "$ref": "#/components/examples/CreateAttributeDefinitionString"
+                },
+                "CreateAttributeDefinitionEnum": {
+                  "$ref": "#/components/examples/CreateAttributeDefinitionEnum"
+                },
+                "CreateAttributeDefinitionNumber": {
+                  "$ref": "#/components/examples/CreateAttributeDefinitionNumber"
+                },
+                "CreateAttributeDefinitionImage": {
+                  "$ref": "#/components/examples/CreateAttributeDefinitionImage"
+                }
               }
             }
           },
@@ -1293,6 +1660,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinition"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionExample"
+                  }
                 }
               }
             }
@@ -1303,6 +1675,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinition"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionCreatedExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionCreatedExample"
+                  }
                 }
               }
             }
@@ -1313,6 +1690,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "InvalidValueTypeExample": {
+                    "$ref": "#/components/examples/BadRequestExample"
+                  }
                 }
               }
             }
@@ -1329,6 +1711,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "ObjectTypeNotFoundExample": {
+                    "$ref": "#/components/examples/ObjectTypeNotFoundExample"
+                  }
                 }
               }
             }
@@ -1343,26 +1730,32 @@
         ]
       },
       "delete": {
+        "summary": "Delete attribute definition",
+        "description": "Deletes an attribute definition by its identifier.\n\nThis operation cannot be undone. The attribute definition will be removed from all\nattribute groups and all values for this attribute will be deleted.\n\n**Important:** System attributes cannot be deleted.\n",
         "operationId": "deleteAttributeDefinition",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1370,11 +1763,13 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute definition.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1396,6 +1791,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeDefinitionNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeDefinitionNotFoundExample"
+                  }
                 }
               }
             }
@@ -1410,26 +1810,32 @@
         ]
       },
       "patch": {
+        "summary": "Update attribute definition",
+        "description": "Partially updates an existing attribute definition.\n\nOnly the properties provided in the request body will be updated.\n\n**Important:** The `valueType` property cannot be changed after creation.\nSystem attributes have limited modifiable properties.\n",
         "operationId": "updateAttributeDefinition",
         "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": "objectType",
             "in": "path",
+            "description": "The system object type identifier (e.g., Product, Order, Customer)",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "Product",
               "maxLength": 256,
               "minLength": 1
             }
@@ -1437,21 +1843,29 @@
           {
             "name": "id",
             "in": "path",
+            "description": "The unique identifier of the attribute definition.",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "type": "string",
+              "example": "color",
               "maxLength": 256,
               "minLength": 1
             }
           }
         ],
         "requestBody": {
+          "description": "The attribute definition data to update",
           "content": {
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/ObjectAttributeDefinition"
+              },
+              "examples": {
+                "UpdateAttributeDefinition": {
+                  "$ref": "#/components/examples/UpdateAttributeDefinition"
+                }
               }
             }
           },
@@ -1464,6 +1878,11 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ObjectAttributeDefinition"
+                },
+                "examples": {
+                  "ObjectAttributeDefinitionExample": {
+                    "$ref": "#/components/examples/ObjectAttributeDefinitionExample"
+                  }
                 }
               }
             }
@@ -1474,6 +1893,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "MalformedRequestBodyExample": {
+                    "$ref": "#/components/examples/MalformedRequestBodyExample"
+                  }
                 }
               }
             }
@@ -1490,6 +1914,11 @@
               "application/problem+json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "AttributeDefinitionNotFoundExample": {
+                    "$ref": "#/components/examples/AttributeDefinitionNotFoundExample"
+                  }
                 }
               }
             }
@@ -1509,10 +1938,14 @@
     "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})$"
       },
       "Select": {
         "type": "string",
+        "description": "The property selector declaring which fields are included into the response payload. You can specify a single field name, a comma-separated list of names or work with wildcards. You can also specify array operations and filter expressions. The actual selector value must be enclosed within parentheses. For more information, please read the documentation about property selectors [here](https://developer.salesforce.com/docs/commerce/commerce-api/guide/scapi-property-selection.html).",
+        "example": "(name,id,variationAttributes.(**))",
         "minLength": 1,
         "pattern": "^[(].*[)]$"
       },
@@ -1520,14 +1953,19 @@
         "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"
@@ -1542,6 +1980,8 @@
         "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": {
@@ -1550,6 +1990,7 @@
             "$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"
@@ -1563,46 +2004,79 @@
       },
       "ObjectTypeDefinition": {
         "type": "object",
+        "description": "Document representing a system object type definition",
         "properties": {
           "objectType": {
             "type": "string",
+            "description": "The unique identifier of the system object type",
+            "example": "Product",
             "maxLength": 256
           },
           "displayName": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Product",
+              "de": "Produkt",
+              "en": "Product"
+            },
+            "x-format": "localized"
           },
           "description": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Object type representing products.",
+              "de": "Objekttyp, der Produkte repräsentiert.",
+              "en": "Object type representing products."
+            },
+            "x-format": "localized"
           },
           "readOnly": {
             "type": "boolean",
+            "description": "Flag indicating if this object type is read-only",
+            "example": false,
             "readOnly": true
           },
           "queryable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this object type can be queried",
+            "example": true
           },
           "searchable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this object type is searchable",
+            "example": true
           },
           "contentObject": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this is a content object",
+            "example": true
           },
           "attributeDefinitionCount": {
             "type": "integer",
             "format": "int32",
+            "description": "The number of attribute definitions for this object type",
+            "example": 150,
             "readOnly": true
           },
           "attributeGroupCount": {
             "type": "integer",
             "format": "int32",
+            "description": "The number of attribute groups for this object type",
+            "example": 8,
             "readOnly": true
           }
         }
@@ -1613,9 +2087,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing a paginated collection of object type definition",
         "properties": {
           "data": {
             "type": "array",
+            "description": "List of system object types",
             "items": {
               "$ref": "#/components/schemas/ObjectTypeDefinition"
             }
@@ -1628,17 +2104,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
           }
         },
@@ -1651,6 +2135,28 @@
       "Query": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A set of objects that define criteria used to select records. A query can contain one of the following:\n* `MatchAllQuery`\n - Matches all documents.\n* `TermQuery`\n - Matches one or more documents against one or more document fields.\n* `TextQuery`\n - Matches text against one or more fields.\n* `BoolQuery`\n - Allows construction of a logical expression of multiple queries.\n* `FilteredQuery`\n - Allows a filter to be applied to a query.\n* `NestedQuery`\n - Allows you to query on nested documents.\n - _Only supported by some Commerce APIs. For more details, see the endpoint descriptions in the API documentation._",
+        "example": {
+          "filteredQuery": {
+            "query": {
+              "textQuery": {
+                "fields": [
+                  "couponId"
+                ],
+                "searchPhrase": "disabled"
+              }
+            },
+            "filter": {
+              "termFilter": {
+                "field": "enabled",
+                "operator": "is",
+                "values": [
+                  false
+                ]
+              }
+            }
+          }
+        },
         "maxProperties": 1,
         "minProperties": 1,
         "properties": {
@@ -1677,21 +2183,58 @@
       "BoolQuery": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A boolean query allows construction of full logical expression trees that are composed of other queries (usually term queries and text queries). A boolean query has three sets of clauses:\n  \n  - `must`, which combines as an `AND` operator.\n  - `should`, which combines as an `OR` operator.\n  - `must_not`, which combines as a `NOT` operator.\n  \nIf `must`, `mustNot`, or `should` appear in the same boolean query, they are combined logically using the `AND` operator. For example:\n\n    (must-1 AND must-1 AND ...)\n      AND (should-1 OR should-2 OR ...)\n      AND NOT (must_not-1 OR must_not-2 OR ...)\n",
+        "example": {
+          "must": [
+            {
+              "textQuery": {
+                "fields": [
+                  "couponId"
+                ],
+                "searchPhrase": "DEAL"
+              }
+            },
+            {
+              "textQuery": {
+                "fields": [
+                  "description"
+                ],
+                "searchPhrase": "Big bargain deal"
+              }
+            }
+          ],
+          "mustNot": [
+            {
+              "termQuery": {
+                "fields": [
+                  "enabled"
+                ],
+                "operator": "is",
+                "values": [
+                  false
+                ]
+              }
+            }
+          ]
+        },
         "properties": {
           "must": {
             "type": "array",
+            "description": "List of queries to be evaluated as an `AND` operator.",
             "items": {
               "$ref": "#/components/schemas/Query"
             }
           },
           "mustNot": {
             "type": "array",
+            "description": "List of queries to be evaluated as a `NOT` operator.",
             "items": {
               "$ref": "#/components/schemas/Query"
             }
           },
           "should": {
             "type": "array",
+            "description": "List of queries to be evaluated as an `OR` operator.",
             "items": {
               "$ref": "#/components/schemas/Query"
             }
@@ -1701,6 +2244,7 @@
       "Filter": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Contains a set of objects that define criteria used to select records. A filter can contain one of the following:\n  * `TermFilter`\n   - Matches records where a field (or fields) exactly matches some simple value (including `null`).\n  * `RangeFilter`\n   - Matches records where a field value lies within a specified range.\n  * `Range2Filter`\n   - Matches records in a specified range across fields.\n  * `QueryFilter`\n   - Matches records based on a query.\n  * `BoolFilter`\n   - Provides filtering of records using a set of filters combined using a logical operator.",
         "maxProperties": 1,
         "minProperties": 1,
         "properties": {
@@ -1724,20 +2268,47 @@
       "BoolFilter": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Allows you to combine other filters into (possibly recursive) logical expression trees. A boolean filter is composed of a logical operator (`AND`, `OR`, `NOT`) and a list of filters that the operator relates to. Multiple filters can be negated with a single `NOT` operator, even when the filters are combined with the `AND` operator.",
+        "example": {
+          "operator": "and",
+          "filters": [
+            {
+              "termFilter": {
+                "field": "id",
+                "operator": "is",
+                "values": [
+                  "myId"
+                ]
+              }
+            },
+            {
+              "termFilter": {
+                "field": "couponId",
+                "operator": "is",
+                "values": [
+                  "couponOne"
+                ]
+              }
+            }
+          ]
+        },
         "properties": {
           "filters": {
             "type": "array",
+            "description": "A list of filters that are logically combined by an operator.",
             "items": {
               "$ref": "#/components/schemas/Filter"
             }
           },
           "operator": {
             "type": "string",
+            "description": "The logical operator that is used to combine the filters.",
             "enum": [
               "and",
               "or",
               "not"
-            ]
+            ],
+            "example": "and"
           }
         },
         "required": [
@@ -1746,6 +2317,7 @@
       },
       "QueryFilter": {
         "type": "object",
+        "description": "Wraps any query and allows it to be used as a filter.",
         "properties": {
           "query": {
             "$ref": "#/components/schemas/Query"
@@ -1757,45 +2329,71 @@
       },
       "Field": {
         "type": "string",
+        "description": "Name of the field. Might be a custom field name prefixed with c_.",
+        "example": "couponId",
         "maxLength": 260
       },
       "Range2Filter": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Allows you to restrict a search result to hits where a range defined by specified attributes has a certain relationship to a specified range.\n\nThe first range (R1) is defined by a pair of attributes (`fromField` and `toField`) that specify the extent of a range, such as attributes `validFrom` and `validTo`.\n\nThe second range (R2) is defined by `fromValue` and `toValue`.\n\nThe filter mode specifies the method used to compare the two ranges:\n\n* `overlap`: R1 overlaps fully or partially with R2.\n* `containing`: R1 contains R2.\n* `contained`: R1 is contained in R2.\n\nThe range filter supports several value types, and relies on the natural sorting of the value type for range interpretation. Value ranges can be open-ended, but only at one end of the range. You can configure whether the lower bounds and upper bounds are inclusive or exclusive.\n\nA range 2 filter is useful for general restrictions that can be shared between searches (like a static date range) because the filter result is cached in memory. Range filters are not appropriate if the range is expected to be different for every query (for example, if the user controls the date range down to the hour via a UI control). Range filters are inclusive by default.",
+        "example": {
+          "fromField": "validFrom",
+          "toField": "validTo",
+          "filterMode": "overlap",
+          "fromValue": "2007-01-01T00:00:00.000Z",
+          "toValue": "2017-01-01T00:00:00.000Z"
+        },
         "properties": {
           "filterMode": {
             "type": "string",
             "default": "overlap",
+            "description": "Compare mode: overlap, containing, or contained.",
             "enum": [
               "overlap",
               "containing",
               "contained"
-            ]
+            ],
+            "example": "overlap"
           },
           "fromField": {
             "allOf": [
               {
                 "$ref": "#/components/schemas/Field"
               }
-            ]
+            ],
+            "description": "The field name of the field that starts the first range.",
+            "example": "validFrom"
           },
           "fromInclusive": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "A flag indicating if the lower bound of the second range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
+          },
+          "fromValue": {
+            "description": "The lower bound of the second range. If not specified, the range is open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.",
+            "example": "2007-01-01T00:00:00.000Z"
           },
-          "fromValue": {},
           "toField": {
             "allOf": [
               {
                 "$ref": "#/components/schemas/Field"
               }
-            ]
+            ],
+            "description": "The field name of the field that ends the first range.",
+            "example": "validTo"
           },
           "toInclusive": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "A flag indicating if the upper bound of the second range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
           },
-          "toValue": {}
+          "toValue": {
+            "description": "The upper bound of the second range. If not specified, the range is open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.",
+            "example": "2017-01-01T00:00:00.000Z"
+          }
         },
         "required": [
           "fromField",
@@ -1804,49 +2402,64 @@
       },
       "RangeFilter": {
         "type": "object",
+        "description": "Allows you to restrict a search result to hits that have values for a given attribute that fall within a given value range. The range filter supports several value types and relies on the natural sorting of the value type for range interpretation. Value ranges can be open-ended, but only at one end of the range. You can configure whether the lower bounds and upper bounds are inclusive or exclusive.\n\nA range filter is useful for general restrictions that can be shared between searches (like a static date range) because the filter result is cached in memory. Range filters are not appropriate if the range is expected to be different for every query (for example, if the user controls the date range down to the hour via a UI control). Range filters are inclusive by default.",
         "properties": {
           "field": {
             "allOf": [
               {
                 "$ref": "#/components/schemas/Field"
               }
-            ]
+            ],
+            "description": "The search field.",
+            "example": "validFrom"
           },
           "from": {
+            "description": "The lower bound of the filter range. If not specified, the range is open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.",
             "oneOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "format": "date-time",
+                "example": "2007-01-01T00:00:00Z"
               },
               {
-                "type": "integer"
+                "type": "integer",
+                "example": 1
               },
               {
-                "type": "number"
+                "type": "number",
+                "example": 1
               }
             ]
           },
           "fromInclusive": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "A flag indicating if the lower bound of the range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
           },
           "to": {
+            "description": "The upper bound of the filter range. If not specified, the range is open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.",
             "oneOf": [
               {
                 "type": "string",
-                "format": "date-time"
+                "format": "date-time",
+                "example": "2007-01-02T00:00:00Z"
               },
               {
-                "type": "integer"
+                "type": "integer",
+                "example": 2
               },
               {
-                "type": "number"
+                "type": "number",
+                "example": 2
               }
             ]
           },
           "toInclusive": {
             "type": "boolean",
-            "default": true
+            "default": true,
+            "description": "A flag indicating if the upper bound of the range is inclusive. To make the upper bound exclusive, set to `false`.",
+            "example": true
           }
         },
         "required": [
@@ -1856,16 +2469,26 @@
       "TermFilter": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Allows you to restrict a search result to hits that match exactly one of the values configured for the filter. A term filter is useful for general restrictions that can be shared between searches. Use term filters whenever the criteria you filter on is a shared property of multiple searches (for example, like filtering by an order status). Use term filters for fields that have a discrete and small set of values only.",
+        "example": {
+          "field": "id",
+          "operator": "is",
+          "values": [
+            "myId"
+          ]
+        },
         "properties": {
           "field": {
             "allOf": [
               {
                 "$ref": "#/components/schemas/Field"
               }
-            ]
+            ],
+            "description": "The filter field."
           },
           "operator": {
             "type": "string",
+            "description": "The operator used to compare the field's values with the given values.",
             "enum": [
               "is",
               "one_of",
@@ -1875,12 +2498,15 @@
               "greater",
               "not_in",
               "neq"
-            ]
+            ],
+            "example": "is"
           },
           "values": {
             "type": "array",
+            "description": "The filter values.",
             "items": {
-              "type": "string"
+              "type": "string",
+              "example": "myId"
             }
           }
         },
@@ -1892,6 +2518,26 @@
       "FilteredQuery": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Allows to filter the result of a possibly complex query using a possibly complex filter.",
+        "example": {
+          "query": {
+            "textQuery": {
+              "fields": [
+                "couponId"
+              ],
+              "searchPhrase": "disabled"
+            }
+          },
+          "filter": {
+            "termFilter": {
+              "field": "enabled",
+              "operator": "is",
+              "values": [
+                false
+              ]
+            }
+          }
+        },
         "properties": {
           "filter": {
             "$ref": "#/components/schemas/Filter"
@@ -1906,14 +2552,62 @@
         ]
       },
       "MatchAllQuery": {
-        "type": "object"
+        "type": "object",
+        "description": "Matches all documents (namespace and document type). This query comes in handy if you just want to filter a search result or really do not have any constraints."
       },
       "NestedQuery": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Allows you to query nested documents that are part of a larger document. Say, for example, that you have a main product with variations in one big document, and you want to constrain a search to main products that have variations that match multiple constraints. \n\nA `NestedQuery` is only supported by some Commerce APIs. For more details, see the endpoint descriptions in the API documentation.\n",
+        "example": {
+          "path": "order.shippingAddresses",
+          "query": {
+            "boolQuery": {
+              "must": [
+                {
+                  "boolQuery": {
+                    "must": [
+                      {
+                        "termQuery": {
+                          "fields": [
+                            "order.shippingAddresses.firstName"
+                          ],
+                          "operator": "is",
+                          "values": [
+                            "John"
+                          ]
+                        }
+                      }
+                    ]
+                  }
+                },
+                {
+                  "boolQuery": {
+                    "must": [
+                      {
+                        "termQuery": {
+                          "fields": [
+                            "order.shippingAddresses.lastName"
+                          ],
+                          "operator": "is",
+                          "values": [
+                            "Doe"
+                          ]
+                        }
+                      }
+                    ]
+                  }
+                }
+              ]
+            }
+          },
+          "scoreMode": "avg"
+        },
         "properties": {
           "path": {
             "type": "string",
+            "description": "The path to the nested document.",
+            "example": "order.shippingAddresses",
             "maxLength": 2048
           },
           "query": {
@@ -1921,12 +2615,14 @@
           },
           "scoreMode": {
             "type": "string",
+            "description": "Indicates how scores for matching child objects affect the root parent document’s relevance score.",
             "enum": [
               "avg",
               "total",
               "max",
               "none"
-            ]
+            ],
+            "example": "avg"
           }
         },
         "required": [
@@ -1936,9 +2632,11 @@
       },
       "TermQuery": {
         "type": "object",
+        "description": "A term query matches one or more values against one or more document fields. A document is considered a hit if one of the values matches exactly with at least one of the given fields. The operator `is` can only take one value, while `one_of` can take multiple values. If multiple fields are specified, they are combined using a logical `OR` operator.\n\n**Limitations:**\n\n* The `greater` and `less` operators are not supported under certain conditions. Both operators are permitted unless the API documentation states otherwise.\n* A subset of Commerce APIs handle queries with multiple fields differently. If the query has multiple fields, the query is internally handled as a logical `OR` of `DisjointMaxQueries` (with the dismax matching a value against all fields). The dismax makes sure that a document carrying a single term in multiple fields does not get higher scores than a document matching multiple terms in multiple fields.",
         "properties": {
           "fields": {
             "type": "array",
+            "description": "The document fields that the values are matched against, combined with the operator.",
             "items": {
               "$ref": "#/components/schemas/Field"
             },
@@ -1946,6 +2644,7 @@
           },
           "operator": {
             "type": "string",
+            "description": "Returns the operator to use for the term query.",
             "enum": [
               "is",
               "one_of",
@@ -1955,23 +2654,30 @@
               "greater",
               "not_in",
               "neq"
-            ]
+            ],
+            "example": "is"
           },
           "values": {
             "type": "array",
+            "description": "The values that the fields are compared against, combined with the operator.",
             "items": {
+              "example": "myCouponId",
               "oneOf": [
                 {
-                  "type": "string"
+                  "type": "string",
+                  "example": "myCouponId"
                 },
                 {
-                  "type": "number"
+                  "type": "number",
+                  "example": 1
                 },
                 {
-                  "type": "boolean"
+                  "type": "boolean",
+                  "example": true
                 },
                 {
-                  "type": "integer"
+                  "type": "integer",
+                  "example": 1
                 }
               ]
             }
@@ -1985,16 +2691,26 @@
       "TextQuery": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A text query is used to match some text (for example, a search phrase possibly consisting of multiple terms) against one or more fields. When multiple fields are provided, the phrase conceptually forms a logical `OR` over the fields. In this case, the terms of the phrase basically have to match within the text, that would result in concatenating all given fields.",
+        "example": {
+          "fields": [
+            "couponId"
+          ],
+          "searchPhrase": "limit"
+        },
         "properties": {
           "fields": {
             "type": "array",
+            "description": "The document fields that the search phrase matches against.",
             "items": {
               "$ref": "#/components/schemas/Field"
             },
             "minItems": 1
           },
           "searchPhrase": {
-            "type": "string"
+            "type": "string",
+            "description": "A search phrase, which can include multiple terms separated by spaces.",
+            "example": "campaign summer"
           }
         },
         "required": [
@@ -2005,18 +2721,27 @@
       "Sort": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Document representing a sort request. Each API has a different default sort configuration that can be modified in the request.",
+        "example": {
+          "field": "couponId",
+          "sortOrder": "desc"
+        },
         "properties": {
           "field": {
             "type": "string",
+            "description": "The name of the field to sort on.",
+            "example": "couponId",
             "maxLength": 256
           },
           "sortOrder": {
             "type": "string",
             "default": "asc",
+            "description": "The sort order to be applied when sorting. When omitted, the default sort order (asc) is used.",
             "enum": [
               "asc",
               "desc"
-            ]
+            ],
+            "example": "asc"
           }
         },
         "required": [
@@ -2025,10 +2750,13 @@
       },
       "SearchRequest": {
         "type": "object",
+        "description": "Document representing a search request for retrieving items within the Data API. The query is a potentially complex set of expressions. The fields and expands that each query supports are defined within the search resource.",
         "properties": {
           "limit": {
             "type": "integer",
             "format": "int32",
+            "description": "Maximum records to retrieve per request, not to exceed 200.",
+            "example": 10,
             "maximum": 200,
             "minimum": 1
           },
@@ -2037,6 +2765,7 @@
           },
           "sorts": {
             "type": "array",
+            "description": "The list of sort clauses configured for the search request. Sort clauses are optional. See the description of the search endpoint for details on the default sorting behavior that is used when explicit sorts are not passed.",
             "items": {
               "$ref": "#/components/schemas/Sort"
             }
@@ -2055,9 +2784,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing a system object type search result",
         "properties": {
           "hits": {
             "type": "array",
+            "description": "List of system object types matching the search criteria",
             "items": {
               "$ref": "#/components/schemas/ObjectTypeDefinition"
             }
@@ -2069,6 +2800,7 @@
       },
       "ValueType": {
         "type": "string",
+        "description": "The type of an attribute value",
         "enum": [
           "string",
           "int",
@@ -2088,18 +2820,24 @@
           "set_of_double",
           "enum_of_string",
           "enum_of_int"
-        ]
+        ],
+        "example": "string"
       },
       "ObjectAttributeValueDefinition": {
         "type": "object",
+        "description": "An attribute definition value",
         "properties": {
           "id": {
             "type": "string",
+            "description": "The ID of the attribute value",
+            "example": "value-1",
             "maxLength": 256,
             "readOnly": true
           },
           "value": {
             "type": "string",
+            "description": "The value of the attribute",
+            "example": "1",
             "maxLength": 4000,
             "readOnly": true
           },
@@ -2107,35 +2845,60 @@
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
             },
-            "readOnly": true
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "One",
+              "de": "Eins",
+              "en": "One"
+            },
+            "readOnly": true,
+            "x-format": "localized"
           },
           "description": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
             },
-            "readOnly": true
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Object type representing products.",
+              "de": "Objekttyp, der Produkte repräsentiert.",
+              "en": "Object type representing products."
+            },
+            "readOnly": true,
+            "x-format": "localized"
           },
           "position": {
             "type": "number",
             "format": "double",
+            "description": "The position of the attribute value within the set of attribute values",
+            "example": 1,
             "readOnly": true
           }
         }
       },
       "ObjectAttributeDefinition": {
         "type": "object",
+        "description": "Document representing an attribute definition",
         "properties": {
           "id": {
             "type": "string",
+            "description": "The user supplied ID of the attribute",
+            "example": "color",
             "maxLength": 256,
             "minLength": 1
           },
           "effectiveId": {
             "type": "string",
+            "description": "The effective ID, which is c_id if the attribute is custom, and just the id otherwise",
+            "example": "c_color",
             "maxLength": 256,
             "readOnly": true
           },
@@ -2143,108 +2906,179 @@
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Product",
+              "de": "Produkt",
+              "en": "Product"
+            },
+            "x-format": "localized"
           },
           "description": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Object type representing products.",
+              "de": "Objekttyp, der Produkte repräsentiert.",
+              "en": "Object type representing products."
+            },
+            "x-format": "localized"
           },
           "key": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this is a key attribute",
+            "example": false
           },
           "mandatory": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if a value is mandatory for the attribute",
+            "example": false
           },
           "localizable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute can be localized",
+            "example": false
           },
           "siteSpecific": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is site-specific",
+            "example": false
           },
           "searchable": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is searchable",
+            "example": true
           },
           "queryable": {
             "type": "boolean",
+            "description": "Returns true if the attribute definition is explicitly marked queryable or if the attribute value type belongs to a queryable type. Computed and read-only.",
+            "example": true,
             "readOnly": true
           },
           "valueType": {
             "$ref": "#/components/schemas/ValueType"
           },
           "visible": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is visible",
+            "example": true
           },
           "system": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is a system attribute",
+            "example": false
           },
           "unit": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "General unit",
+              "de": "Allgemeine Einheit",
+              "en": "General unit"
+            },
+            "x-format": "localized"
           },
           "requiresEncoding": {
             "type": "boolean",
+            "description": "Flag indicating if this attribute can be encoded using the encoding='off' flag in ISML templates",
+            "example": false,
             "readOnly": true
           },
           "multiValueType": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "True if the attribute can have multiple values. Applicable to set_of_* and enum_of_* types.",
+            "example": false
           },
           "setValueType": {
             "type": "boolean",
+            "description": "Flag indicating if this attribute is of type 'Set of'",
+            "example": false,
             "readOnly": true
           },
           "externallyManaged": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is externally managed",
+            "example": false
           },
           "externallyDefined": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is externally defined",
+            "example": false
           },
           "orderRequired": {
-            "type": "boolean"
+            "type": "boolean",
+            "description": "Flag indicating if this attribute is required for order of the attribute model's product",
+            "example": false
           },
           "regularExpression": {
             "type": "string",
+            "description": "A regular expression that defines the legal values for this attribute",
+            "example": "^[a-zA-Z]+$",
             "maxLength": 4000,
             "readOnly": true
           },
           "fieldLength": {
             "type": "integer",
             "format": "int32",
+            "description": "The length of the field for this attribute in the editor",
+            "example": 50,
             "readOnly": true
           },
           "fieldHeight": {
             "type": "integer",
             "format": "int32",
+            "description": "The height of the field for this attribute in the editor",
+            "example": 1,
             "readOnly": true
           },
           "minLength": {
             "type": "integer",
             "format": "int32",
+            "description": "The minimum length of the field for this attribute",
+            "example": 1,
             "readOnly": true
           },
           "readOnly": {
             "type": "boolean",
+            "description": "Flag indicating if this attribute is read-only",
+            "example": false,
             "readOnly": true
           },
           "minValue": {
             "type": "number",
             "format": "double",
+            "description": "The minimum possible value for this attribute",
+            "example": 0,
             "readOnly": true
           },
           "maxValue": {
             "type": "number",
             "format": "double",
+            "description": "The maximum possible value for this attribute",
+            "example": 100,
             "readOnly": true
           },
           "scale": {
             "type": "integer",
             "format": "int32",
+            "description": "The minimum number of fraction digits for a value of this attribute",
+            "example": 2,
             "readOnly": true
           },
           "defaultValue": {
@@ -2252,10 +3086,12 @@
               {
                 "$ref": "#/components/schemas/ObjectAttributeValueDefinition"
               }
-            ]
+            ],
+            "description": "The default value of this attribute. It can be updated, but not created."
           },
           "valueDefinitions": {
             "type": "array",
+            "description": "A set of values that are possible for this attribute",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeValueDefinition"
             },
@@ -2264,11 +3100,15 @@
           "creationDate": {
             "type": "string",
             "format": "date-time",
+            "description": "The date/time when the attribute definition was created",
+            "example": "2024-01-15T10:30:00Z",
             "readOnly": true
           },
           "lastModified": {
             "type": "string",
             "format": "date-time",
+            "description": "The date/time when the attribute definition was last modified",
+            "example": "2024-01-15T11:00:00Z",
             "readOnly": true
           }
         },
@@ -2282,9 +3122,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing an attribute definition search result",
         "properties": {
           "hits": {
             "type": "array",
+            "description": "List of object attribute definitions",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeDefinition"
             }
@@ -2296,9 +3138,12 @@
       },
       "ObjectAttributeGroup": {
         "type": "object",
+        "description": "Document representing an attribute group",
         "properties": {
           "id": {
             "type": "string",
+            "description": "The unique identifier of the attribute group",
+            "example": "custom-attributes",
             "maxLength": 256,
             "minLength": 1
           },
@@ -2306,31 +3151,56 @@
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Product",
+              "de": "Produkt",
+              "en": "Product"
+            },
+            "x-format": "localized"
           },
           "description": {
             "type": "object",
             "additionalProperties": {
               "type": "string",
+              "description": "Localized string",
+              "example": "Localized value",
               "maxLength": 4000
-            }
+            },
+            "description": "B2C Commerce API - Localization doc: https://developer.salesforce.com/docs/commerce/commerce-api/guide/b2c-localization.html",
+            "example": {
+              "default": "Object type representing products.",
+              "de": "Objekttyp, der Produkte repräsentiert.",
+              "en": "Object type representing products."
+            },
+            "x-format": "localized"
           },
           "position": {
             "type": "number",
-            "format": "double"
+            "format": "double",
+            "description": "The position of the attribute group",
+            "example": 1
           },
           "internal": {
             "type": "boolean",
+            "description": "Flag indicating if this is an internal attribute group",
+            "example": false,
             "readOnly": true
           },
           "attributeDefinitionsCount": {
             "type": "integer",
             "format": "int32",
+            "description": "The number of attribute definitions in this group",
+            "example": 5,
             "readOnly": true
           },
           "attributeDefinitions": {
             "type": "array",
+            "description": "The attribute definitions in this group. Only populated when expand=definition is specified.",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeDefinition"
             }
@@ -2338,11 +3208,15 @@
           "creationDate": {
             "type": "string",
             "format": "date-time",
+            "description": "The date/time when the attribute definition was created",
+            "example": "2024-01-15T10:30:00Z",
             "readOnly": true
           },
           "lastModified": {
             "type": "string",
             "format": "date-time",
+            "description": "The date/time when the attribute definition was last modified",
+            "example": "2024-01-15T11:00:00Z",
             "readOnly": true
           }
         }
@@ -2353,9 +3227,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing an attribute group search result",
         "properties": {
           "hits": {
             "type": "array",
+            "description": "List of object attribute groups",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeGroup"
             }
@@ -2371,9 +3247,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing a paginated collection of attribute groups",
         "properties": {
           "data": {
             "type": "array",
+            "description": "List of object attribute groups",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeGroup"
             }
@@ -2386,9 +3264,11 @@
             "$ref": "#/components/schemas/PaginatedResultBase"
           }
         ],
+        "description": "Document representing a paginated collection of attribute definitions",
         "properties": {
           "data": {
             "type": "array",
+            "description": "List of object attribute definitions",
             "items": {
               "$ref": "#/components/schemas/ObjectAttributeDefinition"
             }
@@ -2403,6 +3283,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "UnauthorizedExample": {
+                "$ref": "#/components/examples/UnauthorizedExample"
+              }
             }
           }
         }
@@ -2413,6 +3298,11 @@
           "application/problem+json": {
             "schema": {
               "$ref": "#/components/schemas/ErrorResponse"
+            },
+            "examples": {
+              "ForbiddenExample": {
+                "$ref": "#/components/examples/ForbiddenExample"
+              }
             }
           }
         }
@@ -2422,12 +3312,14 @@
       "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"
       },
       "select": {
         "name": "select",
@@ -2437,16 +3329,23 @@
         "explode": true,
         "schema": {
           "$ref": "#/components/schemas/Select"
+        },
+        "examples": {
+          "select": {
+            "value": "(**)"
+          }
         }
       },
       "objectType": {
         "name": "objectType",
         "in": "path",
+        "description": "The system object type identifier (e.g., Product, Order, Customer)",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "Product",
           "maxLength": 256,
           "minLength": 1
         }
@@ -2454,22 +3353,26 @@
       "expand": {
         "name": "expand",
         "in": "query",
+        "description": "Specifies which related resources to include in the response.\nFor attribute groups, use `definition` to include attribute definitions.\n",
         "required": false,
         "style": "form",
         "explode": true,
         "schema": {
           "type": "string",
+          "example": "definition",
           "maxLength": 256
         }
       },
       "attributeGroupId": {
         "name": "id",
         "in": "path",
+        "description": "The unique identifier of the attribute group.",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "custom-attributes",
           "maxLength": 256,
           "minLength": 1
         }
@@ -2477,11 +3380,13 @@
       "groupId": {
         "name": "groupId",
         "in": "path",
+        "description": "The unique identifier of the attribute group.",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "custom-attributes",
           "maxLength": 256,
           "minLength": 1
         }
@@ -2489,11 +3394,13 @@
       "defId": {
         "name": "defId",
         "in": "path",
+        "description": "The unique identifier of the attribute definition to assign or unassign.",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "color",
           "maxLength": 256,
           "minLength": 1
         }
@@ -2501,19 +3408,733 @@
       "attributeDefinitionId": {
         "name": "id",
         "in": "path",
+        "description": "The unique identifier of the attribute definition.",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "type": "string",
+          "example": "color",
           "maxLength": 256,
           "minLength": 1
         }
       }
     },
+    "examples": {
+      "SystemObjectTypeResultExample": {
+        "summary": "List of system object types",
+        "value": {
+          "limit": 3,
+          "offset": 0,
+          "total": 85,
+          "data": [
+            {
+              "objectType": "Product",
+              "displayName": {
+                "default": "Product"
+              },
+              "description": {
+                "default": "Object type representing products."
+              },
+              "readOnly": false,
+              "queryable": false,
+              "contentObject": true,
+              "attributeDefinitionCount": 166,
+              "attributeGroupCount": 8
+            },
+            {
+              "objectType": "Order",
+              "displayName": {
+                "default": "Order"
+              },
+              "description": {
+                "default": "Object type representing orders."
+              },
+              "readOnly": false,
+              "queryable": true,
+              "contentObject": false,
+              "attributeDefinitionCount": 120,
+              "attributeGroupCount": 5
+            },
+            {
+              "objectType": "Customer",
+              "displayName": {
+                "default": "Customer"
+              },
+              "description": {
+                "default": "Object type representing customers."
+              },
+              "readOnly": false,
+              "queryable": true,
+              "contentObject": false,
+              "attributeDefinitionCount": 45,
+              "attributeGroupCount": 3
+            }
+          ]
+        }
+      },
+      "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"
+        }
+      },
+      "ObjectTypeNotFoundExample": {
+        "value": {
+          "title": "Object Type Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/object-type-not-found",
+          "detail": "No object type with ID 'InvalidObjectType' could be found.",
+          "objectType": "InvalidObjectType"
+        }
+      },
+      "SearchSystemObjectTypes": {
+        "summary": "Search system object types by object type",
+        "value": {
+          "query": {
+            "textQuery": {
+              "fields": [
+                "objectType"
+              ],
+              "searchPhrase": "Customer"
+            }
+          }
+        }
+      },
+      "SystemObjectTypeSearchResultExample": {
+        "summary": "System object type search result",
+        "value": {
+          "limit": 1,
+          "offset": 0,
+          "total": 1,
+          "hits": [
+            {
+              "objectType": "Customer",
+              "displayName": {
+                "default": "Customer"
+              },
+              "description": {
+                "default": "Object type representing customers."
+              },
+              "readOnly": false,
+              "queryable": true,
+              "contentObject": false,
+              "attributeDefinitionCount": 45,
+              "attributeGroupCount": 3
+            }
+          ]
+        }
+      },
+      "FieldNotSortableExample": {
+        "value": {
+          "title": "Field Not Sortable",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/field-not-sortable",
+          "detail": "The field 'link' can't be used to sort the results."
+        }
+      },
+      "SystemObjectTypeExample": {
+        "summary": "Single system object type",
+        "value": {
+          "objectType": "Product",
+          "displayName": {
+            "default": "Product"
+          },
+          "description": {
+            "default": "Object type representing products."
+          },
+          "readOnly": false,
+          "queryable": false,
+          "searchable": true,
+          "contentObject": true,
+          "attributeDefinitionCount": 166,
+          "attributeGroupCount": 8
+        }
+      },
+      "SearchByValueType": {
+        "summary": "Search by value type using term query",
+        "value": {
+          "query": {
+            "termQuery": {
+              "fields": [
+                "value_type"
+              ],
+              "operator": "is",
+              "values": [
+                "string"
+              ]
+            }
+          },
+          "limit": 25,
+          "offset": 0
+        }
+      },
+      "SearchWithSorting": {
+        "summary": "Search all with sorting by ID",
+        "value": {
+          "query": {
+            "matchAllQuery": {}
+          },
+          "limit": 100,
+          "offset": 0,
+          "sorts": [
+            {
+              "field": "id",
+              "sortOrder": "asc"
+            }
+          ]
+        }
+      },
+      "ObjectAttributeDefinitionSearchResultExample": {
+        "summary": "Successful attribute definition search result",
+        "value": {
+          "limit": 2,
+          "hits": [
+            {
+              "id": "color",
+              "effectiveId": "c_color",
+              "displayName": {
+                "default": "Color"
+              },
+              "description": {
+                "default": "The color of the product"
+              },
+              "key": false,
+              "mandatory": false,
+              "localizable": false,
+              "siteSpecific": false,
+              "searchable": true,
+              "queryable": true,
+              "valueType": "enum_of_string",
+              "visible": true,
+              "system": false,
+              "multiValueType": false,
+              "setValueType": false,
+              "externallyManaged": false,
+              "externallyDefined": false,
+              "orderRequired": false,
+              "requiresEncoding": false,
+              "readOnly": false,
+              "valueDefinitions": [
+                {
+                  "id": "red",
+                  "value": "red",
+                  "displayValue": {
+                    "default": "Red"
+                  },
+                  "position": 1
+                },
+                {
+                  "id": "blue",
+                  "value": "blue",
+                  "displayValue": {
+                    "default": "Blue"
+                  },
+                  "position": 2
+                }
+              ]
+            },
+            {
+              "id": "size",
+              "effectiveId": "c_size",
+              "displayName": {
+                "default": "Size"
+              },
+              "description": {
+                "default": "The size of the product"
+              },
+              "key": false,
+              "mandatory": true,
+              "localizable": false,
+              "siteSpecific": false,
+              "searchable": true,
+              "queryable": true,
+              "valueType": "string",
+              "visible": true,
+              "system": false,
+              "multiValueType": false,
+              "setValueType": false,
+              "externallyManaged": false,
+              "externallyDefined": false,
+              "orderRequired": false,
+              "requiresEncoding": false,
+              "readOnly": false
+            }
+          ],
+          "offset": 0,
+          "total": 2
+        }
+      },
+      "SearchAttributeGroups": {
+        "summary": "Search attribute groups",
+        "value": {
+          "query": {
+            "matchAllQuery": {}
+          },
+          "limit": 25,
+          "offset": 0
+        }
+      },
+      "SearchAttributeGroupsByDisplayName": {
+        "summary": "Search attribute groups by display name",
+        "value": {
+          "query": {
+            "textQuery": {
+              "fields": [
+                "display_name"
+              ],
+              "searchPhrase": "custom"
+            }
+          },
+          "limit": 25,
+          "offset": 0
+        }
+      },
+      "ObjectAttributeGroupSearchResultExample": {
+        "summary": "Attribute group search result",
+        "value": {
+          "limit": 1,
+          "offset": 0,
+          "total": 1,
+          "hits": [
+            {
+              "id": "SiteMap",
+              "displayName": {
+                "default": "Site Map"
+              },
+              "description": {
+                "default": "Site map attributes"
+              },
+              "position": 3,
+              "internal": false,
+              "attributeDefinitionsCount": 3
+            }
+          ]
+        }
+      },
+      "ObjectAttributeGroupResultExample": {
+        "summary": "List of attribute groups",
+        "value": {
+          "limit": 3,
+          "offset": 0,
+          "total": 8,
+          "data": [
+            {
+              "id": "custom-attributes",
+              "displayName": {
+                "default": "Custom Attributes"
+              },
+              "description": {
+                "default": "Custom attributes for the object"
+              },
+              "position": 1,
+              "internal": false,
+              "attributeDefinitionsCount": 5
+            },
+            {
+              "id": "marketing",
+              "displayName": {
+                "default": "Marketing"
+              },
+              "description": {
+                "default": "Marketing related attributes"
+              },
+              "position": 2,
+              "internal": false,
+              "attributeDefinitionsCount": 10
+            },
+            {
+              "id": "SiteMap",
+              "displayName": {
+                "default": "Site Map"
+              },
+              "description": {
+                "default": "Site map attributes"
+              },
+              "position": 3,
+              "internal": false,
+              "attributeDefinitionsCount": 3
+            }
+          ]
+        }
+      },
+      "ObjectAttributeGroupExample": {
+        "summary": "Single attribute group",
+        "value": {
+          "id": "custom-attributes",
+          "displayName": {
+            "default": "Custom Attributes",
+            "en": "Custom Attributes",
+            "de": "Benutzerdefinierte Attribute"
+          },
+          "description": {
+            "default": "Custom attributes for the object"
+          },
+          "position": 1,
+          "internal": false,
+          "attributeDefinitionsCount": 5
+        }
+      },
+      "ObjectAttributeGroupWithDefinitionsExample": {
+        "summary": "Attribute group with expanded attribute definitions",
+        "value": {
+          "id": "custom-attributes",
+          "displayName": {
+            "default": "Custom Attributes"
+          },
+          "description": {
+            "default": "Custom attributes for the object"
+          },
+          "position": 1,
+          "internal": false,
+          "attributeDefinitionsCount": 2,
+          "attributeDefinitions": [
+            {
+              "id": "color",
+              "displayName": {
+                "default": "Color"
+              },
+              "valueType": "enum_of_string",
+              "visible": true,
+              "system": false
+            },
+            {
+              "id": "size",
+              "displayName": {
+                "default": "Size"
+              },
+              "valueType": "string",
+              "visible": true,
+              "system": false
+            }
+          ]
+        }
+      },
+      "AttributeGroupNotFoundExample": {
+        "value": {
+          "title": "Attribute Group Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/attribute-group-not-found",
+          "detail": "No attribute group with ID 'invalid_group' could be found."
+        }
+      },
+      "CreateAttributeGroup": {
+        "summary": "Create an attribute group",
+        "value": {
+          "displayName": {
+            "default": "New Attribute Group",
+            "en": "New Attribute Group",
+            "de": "Neue Attributgruppe"
+          },
+          "description": {
+            "default": "A new group for custom attributes"
+          },
+          "position": 5
+        }
+      },
+      "CreateAttributeGroupWithInternal": {
+        "summary": "Create an internal attribute group",
+        "value": {
+          "displayName": {
+            "default": "Internal Group"
+          },
+          "description": {
+            "default": "An internal attribute group"
+          },
+          "position": 10
+        }
+      },
+      "ObjectAttributeGroupCreatedExample": {
+        "summary": "Attribute group created successfully",
+        "value": {
+          "id": "new-group",
+          "displayName": {
+            "default": "New Group",
+            "en": "New Group"
+          },
+          "description": {
+            "default": "A new attribute group"
+          },
+          "position": 6,
+          "internal": false,
+          "attributeDefinitionsCount": 0
+        }
+      },
+      "IdConflictExample": {
+        "value": {
+          "title": "Id Conflict",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/id-conflict",
+          "detail": "The ID in the request body ('attributegroupId') doesn't match the ID in the URL ('differentId')."
+        }
+      },
+      "UpdateAttributeGroup": {
+        "summary": "Update an attribute group",
+        "value": {
+          "displayName": {
+            "default": "Updated Group Name"
+          },
+          "description": {
+            "default": "Updated description"
+          },
+          "position": 3
+        }
+      },
+      "UpdateAttributeGroupPosition": {
+        "summary": "Update attribute group position",
+        "value": {
+          "position": 1
+        }
+      },
+      "MalformedRequestBodyExample": {
+        "value": {
+          "title": "Bad Request",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/bad-request",
+          "detail": "An error occurred while decoding the request, the body was '{ invalid json }'."
+        }
+      },
+      "AttributeDefinitionNotFoundExample": {
+        "value": {
+          "title": "Attribute Definition Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/attribute-definition-not-found",
+          "detail": "No attribute definition with ID 'invalid_attribute' for object 'Product' could be found.",
+          "attributeDefinitionId": "invalid_attribute",
+          "objectType": "Product"
+        }
+      },
+      "ObjectAttributeDefinitionResultExample": {
+        "summary": "List of attribute definitions",
+        "value": {
+          "limit": 2,
+          "offset": 0,
+          "total": 50,
+          "data": [
+            {
+              "id": "color",
+              "effectiveId": "c_color",
+              "displayName": {
+                "default": "Color"
+              },
+              "description": {
+                "default": "The color of the product"
+              },
+              "key": false,
+              "mandatory": false,
+              "localizable": false,
+              "siteSpecific": false,
+              "searchable": true,
+              "queryable": true,
+              "valueType": "enum_of_string",
+              "visible": true,
+              "system": false
+            },
+            {
+              "id": "size",
+              "effectiveId": "c_size",
+              "displayName": {
+                "default": "Size"
+              },
+              "description": {
+                "default": "The size of the product"
+              },
+              "key": false,
+              "mandatory": true,
+              "localizable": false,
+              "siteSpecific": false,
+              "searchable": true,
+              "queryable": true,
+              "valueType": "string",
+              "visible": true,
+              "system": false
+            }
+          ]
+        }
+      },
+      "ObjectAttributeDefinitionExample": {
+        "summary": "Single attribute definition",
+        "value": {
+          "id": "color",
+          "effectiveId": "c_color",
+          "displayName": {
+            "default": "Color",
+            "en": "Color"
+          },
+          "description": {
+            "default": "The color of the product",
+            "en": "The color of the product"
+          },
+          "key": false,
+          "mandatory": false,
+          "localizable": true,
+          "siteSpecific": false,
+          "searchable": true,
+          "queryable": true,
+          "valueType": "enum_of_string",
+          "visible": true,
+          "system": false,
+          "multiValueType": false,
+          "setValueType": false,
+          "externallyManaged": false,
+          "externallyDefined": false,
+          "orderRequired": false,
+          "requiresEncoding": false,
+          "readOnly": false,
+          "valueDefinitions": [
+            {
+              "id": "red",
+              "value": "red",
+              "displayValue": {
+                "default": "Red"
+              },
+              "position": 1
+            },
+            {
+              "id": "blue",
+              "value": "blue",
+              "displayValue": {
+                "default": "Blue"
+              },
+              "position": 2
+            }
+          ],
+          "creationDate": "2024-01-15T10:30:00Z",
+          "lastModified": "2024-01-15T10:30:00Z"
+        }
+      },
+      "CreateAttributeDefinitionString": {
+        "summary": "Create a string attribute definition",
+        "value": {
+          "id": "c_customString",
+          "displayName": {
+            "default": "Custom String Attribute",
+            "en": "Custom String Attribute"
+          },
+          "description": {
+            "default": "A custom string attribute"
+          },
+          "localizable": true,
+          "siteSpecific": false,
+          "searchable": true,
+          "visible": true,
+          "valueType": "string"
+        }
+      },
+      "CreateAttributeDefinitionEnum": {
+        "summary": "Create an enum attribute definition",
+        "value": {
+          "id": "c_productStatus",
+          "displayName": {
+            "default": "Product Status",
+            "en": "Product Status"
+          },
+          "description": {
+            "default": "The status of the product"
+          },
+          "localizable": false,
+          "siteSpecific": false,
+          "searchable": true,
+          "visible": true,
+          "valueType": "enum_of_string"
+        }
+      },
+      "CreateAttributeDefinitionNumber": {
+        "summary": "Create a numeric attribute definition",
+        "value": {
+          "id": "c_weight",
+          "displayName": {
+            "default": "Weight"
+          },
+          "description": {
+            "default": "The weight of the product"
+          },
+          "localizable": false,
+          "siteSpecific": false,
+          "searchable": true,
+          "visible": true,
+          "valueType": "double",
+          "unit": {
+            "default": "kg"
+          }
+        }
+      },
+      "CreateAttributeDefinitionImage": {
+        "summary": "Create an image attribute definition",
+        "value": {
+          "id": "c_customImage",
+          "displayName": {
+            "default": "Custom Image",
+            "en": "Custom Image"
+          },
+          "description": {
+            "default": "A custom image attribute"
+          },
+          "localizable": true,
+          "siteSpecific": false,
+          "visible": true,
+          "valueType": "image"
+        }
+      },
+      "ObjectAttributeDefinitionCreatedExample": {
+        "summary": "Attribute definition created successfully",
+        "value": {
+          "id": "custom-attribute",
+          "effectiveId": "c_custom-attribute",
+          "displayName": {
+            "default": "Custom Attribute"
+          },
+          "description": {
+            "default": "A custom attribute for the product"
+          },
+          "key": false,
+          "mandatory": false,
+          "localizable": true,
+          "siteSpecific": false,
+          "searchable": true,
+          "queryable": true,
+          "valueType": "string",
+          "visible": true,
+          "system": false,
+          "multiValueType": false,
+          "setValueType": false,
+          "externallyManaged": false,
+          "externallyDefined": false,
+          "orderRequired": false,
+          "requiresEncoding": false,
+          "readOnly": false,
+          "creationDate": "2024-01-15T10:30:00Z",
+          "lastModified": "2024-01-15T10:30:00Z"
+        }
+      },
+      "BadRequestExample": {
+        "value": {
+          "title": "Bad Request",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/bad-request",
+          "detail": "An error occurred while decoding the request. There's an unknown property 'internal' in document 'ObjectAttributeDefinition'."
+        }
+      },
+      "UpdateAttributeDefinition": {
+        "summary": "Update an attribute definition",
+        "value": {
+          "id": "c_customString",
+          "displayName": {
+            "default": "Updated Display Name"
+          },
+          "description": {
+            "default": "Updated description"
+          },
+          "searchable": false,
+          "visible": false
+        }
+      }
+    },
     "securitySchemes": {
       "AmOAuth2": {
         "type": "oauth2",
+        "description": "Account Manager OAuth 2.0 bearer token Authentication.",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
@@ -2525,10 +4146,8 @@
           "authorizationCode": {
             "authorizationUrl": "https://account.demandware.com/dwsso/oauth2/authorize",
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
-            "scopes": {
-              "sfcc.object-definitions": "System Object Definitions Read SCOPE",
-              "sfcc.object-definitions.rw": "System Object Definitions Read and Write SCOPE"
-            }
+            "refreshUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
+            "scopes": {}
           }
         }
       }