fixes

Author: shahednasser

www/apps/api-reference/specs/admin/components/schemas/AdminAuthorizeOrderPaymentSession.yaml

@@ -1,10 +1,10 @@
 type: object
-description: SUMMARY
+description: The details for authorizing a payment session for an order.
 x-schemaName: AdminAuthorizeOrderPaymentSession
 required:
   - payment_session_id
 properties:
   payment_session_id:
     type: string
     title: payment_session_id
-    description: The order's payment session id.
+    description: The payment session's ID.

www/apps/api-reference/specs/admin/components/schemas/AdminAuthorizeOrderPaymentSessionResponse.yaml

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The details of the response after authorizing a payment session for an order.
 x-schemaName: AdminAuthorizeOrderPaymentSessionResponse
 required:
   - order
@@ -10,4 +10,4 @@ properties:
   is_authorized:
     type: boolean
     title: is_authorized
-    description: The order's is authorized.
+    description: Whether the payment session was successfully authorized.

www/apps/api-reference/specs/admin/components/schemas/AdminInvite.yaml

@@ -50,6 +50,7 @@ properties:
     description: The date the invite was updated.
   rbac_roles:
     type: array
-    description: The invite's rbac roles.
+    description: The roles of the invited user.
+    x-featureFlag: rbac
     items:
       $ref: ./AdminRbacRole.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminLayoutConfiguration.yaml

@@ -1,5 +1,5 @@
 type: object
-description: The layout configuration's layout configurations.
+description: The layout configuration's details.
 x-schemaName: AdminLayoutConfiguration
 required:
   - id
@@ -21,31 +21,34 @@ properties:
   user_id:
     type: string
     title: user_id
-    description: The layout configuration's user id.
+    description: The ID of the user who created the layout configuration.
   is_system_default:
     type: boolean
     title: is_system_default
-    description: The layout configuration's is system default.
+    description: Whether the layout configuration is a system default.
   configuration:
     type: object
-    description: The layout configuration's configuration.
+    description: The configuration's details.
     required:
       - widgets
     properties:
       widgets:
         type: object
-        description: The configuration's widgets.
+        description: >-
+          The configurations of the widgets in the layout. The object's keys are
+          the widget IDs, and the values are objects containing the widget's
+          configuration details.
         additionalProperties:
           type: object
           properties:
             hidden:
               type: boolean
               title: hidden
-              description: The widget's hidden.
+              description: Whether the widget is hidden.
             section:
               type: string
               title: section
-              description: The widget's section.
+              description: The section of the layout where the widget is placed.
             order:
               type: number
               title: order
@@ -54,9 +57,9 @@ properties:
     type: string
     format: date-time
     title: created_at
-    description: The layout configuration's created at.
+    description: The date the layout configuration was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The layout configuration's updated at.
+    description: The date the layout configuration was last updated.

www/apps/api-reference/specs/admin/components/schemas/AdminLayoutConfigurationResponse.yaml

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The details for a layout configuration response.
 x-schemaName: AdminLayoutConfigurationResponse
 required:
   - personal_configuration
@@ -12,7 +12,7 @@ properties:
     $ref: ./AdminLayoutConfiguration.yaml
   active_scope:
     type: string
-    description: The layout's active scope.
+    description: The active scope of the layout configuration.
     enum:
       - default
       - personal

www/apps/api-reference/specs/admin/components/schemas/AdminLinkProductOptionWithValues.yaml

@@ -1,5 +1,5 @@
 type: object
-description: The add's details.
+description: The details for linking a product option with its values.
 x-schemaName: AdminLinkProductOptionWithValues
 required:
   - id
@@ -8,11 +8,11 @@ properties:
   id:
     type: string
     title: id
-    description: The add's ID.
+    description: The option's ID.
   value_ids:
     type: array
-    description: The add's value ids.
+    description: The values to add to the product.
     items:
       type: string
       title: value_ids
-      description: The value id's value ids.
+      description: The value's ID.

www/apps/api-reference/specs/admin/components/schemas/AdminLinkProductOptions.yaml

@@ -1,24 +1,24 @@
 type: object
-description: SUMMARY
+description: The details of linking product options to a product.
 x-schemaName: AdminLinkProductOptions
 properties:
   add:
     type: array
-    description: The product's add.
+    description: The options to add to the product.
     items:
       oneOf:
         - type: string
           title: add
-          description: The add's details.
+          description: The details of the product option to add.
         - $ref: ./AdminCreateProductOption.yaml
         - $ref: ./AdminLinkProductOptionWithValues.yaml
   remove:
     type: array
-    description: The product's remove.
+    description: The IDs of the product options to remove from the product.
     items:
       type: string
       title: remove
-      description: The remove's details.
+      description: The ID of the product option to remove.
   update:
     type: array
     description: The product's update.

www/apps/api-reference/specs/admin/components/schemas/AdminProductOptionValueDeleteResponse.yaml

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The details of the product option value deletion.
 x-schemaName: AdminProductOptionValueDeleteResponse
 required:
   - id
@@ -9,14 +9,15 @@ properties:
   id:
     type: string
     title: id
-    description: The product option's ID.
+    description: The ID of the deleted product option value.
   object:
     type: string
     title: object
     description: The name of the deleted object.
+    default: product_option_value
   deleted:
     type: boolean
     title: deleted
-    description: Whether the Product Option was deleted.
+    description: Whether the Product Option Value was deleted.
   parent:
     $ref: ./AdminProductOption.yaml

www/apps/api-reference/specs/admin/components/schemas/AdminProductOptionValueResponse.yaml

@@ -1,5 +1,5 @@
 type: object
-description: SUMMARY
+description: The details of a product option value.
 x-schemaName: AdminProductOptionValueResponse
 required:
   - product_option_value

www/apps/api-reference/specs/admin/components/schemas/AdminRbacPolicy.yaml

@@ -1,5 +1,5 @@
 type: object
-description: The policy's policies.
+description: The details of an RBAC policy.
 x-schemaName: AdminRbacPolicy
 required:
   - id
@@ -24,38 +24,40 @@ properties:
   resource:
     type: string
     title: resource
-    description: The policy's resource.
+    description: The resource that the policy applies to.
+    example: product
   operation:
     type: string
     title: operation
-    description: The policy's operation.
+    description: The operation that the policy allows or denies.
+    example: create
   name:
     type: string
     title: name
-    description: The policy's name.
+    description: The policy's name. Used for display purposes.
   description:
     type: string
     title: description
     description: The policy's description.
   metadata:
     type: object
-    description: The policy's metadata.
+    description: Key-value pairs that hold additional information about the policy.
   inherited_from_role_id:
     type: string
     title: inherited_from_role_id
-    description: The policy's inherited from role id.
+    description: The ID of the role from which the policy is inherited.
   created_at:
     type: string
     format: date-time
     title: created_at
-    description: The policy's created at.
+    description: The date the policy was created.
   updated_at:
     type: string
     format: date-time
     title: updated_at
-    description: The policy's updated at.
+    description: The date the policy was last updated.
   deleted_at:
     type: string
     format: date-time
     title: deleted_at
-    description: The policy's deleted at.
+    description: The date the policy was deleted.