fix: OpenAPI guardian sweep 2026-10-05 (plans, entitlements/features, add-ons)

src/resources/feature_privilege.yml

@@ -16,8 +16,8 @@ parameters:
 delete:
   tags:
     - features
-  summary: Delete a privilege. Deleting a privilege removes it from all plans and subscriptions.
-  description: Delete privilege from feature. Deleting a privilege removes it from all plans and subscriptions.
+  summary: Delete a privilege
+  description: This endpoint deletes a privilege from a feature. Deleting a privilege removes it from all plans and subscriptions.
   operationId: deleteFeaturePrivilege
   responses:
     '200':

src/resources/plan_entitlements.yaml

@@ -55,7 +55,7 @@ patch:
   tags:
     - entitlements
   summary: Partial update of an entitlement
-  description: This accepts a list of entitlements to update. If the feature isn't part of the plan yet, it's added with all the privileges from the payload. If the feature is already part of the plan, the privilege and values are updated or added. All privileges must be valid for the feature. All features  and privileges not part of the payload are left untouched. To remove privileges or features, use the DELETE endpoints.
+  description: This accepts a list of entitlements to update. If the feature isn't part of the plan yet, it's added with all the privileges from the payload. If the feature is already part of the plan, the privilege and values are updated or added. All privileges must be valid for the feature. All features and privileges not part of the payload are left untouched. To remove privileges or features, use the DELETE endpoints.
   operationId: updateEntitlement
   requestBody:
     description: Entitlement payload

src/resources/subscription_entitlement.yaml

@@ -17,17 +17,17 @@ delete:
   tags:
     - entitlements
   summary: Remove an entitlement from a subscription
-  description: This endpoint removes a specific feature entitlement from a subscription. The entitlement remains available from the plan.
+  description: This endpoint removes a specific feature entitlement from a subscription. The entitlement remains available from the plan. It returns the full list of entitlements remaining on the subscription.
   operationId: destroySubscriptionEntitlement
   parameters:
     - $ref: "../parameters/subscription_status.yaml"
   responses:
     '200':
-      description: Subscription entitlement removed
+      description: Remaining subscription entitlements
       content:
         application/json:
           schema:
-            $ref: '../schemas/Entitlement/SubscriptionEntitlement.yaml'
+            $ref: '../schemas/Entitlement/SubscriptionEntitlements.yaml'
     '401':
       $ref: '../responses/Unauthorized.yaml'
     '404':

src/resources/subscription_entitlement_privileges.yaml

@@ -24,17 +24,17 @@ delete:
   tags:
     - entitlements
   summary: Remove a privilege from a subscription entitlement override
-  description: This endpoint removes a specific privilege from a subscription entitlement. The privilege entitlement remains available from the plan.
+  description: This endpoint removes a specific privilege from a subscription entitlement. The privilege entitlement remains available from the plan. It returns the full list of entitlements remaining on the subscription.
   operationId: destroySubscriptionEntitlementPrivilege
   parameters:
     - $ref: "../parameters/subscription_status.yaml"
   responses:
     '200':
-      description: Subscription entitlement with privilege override removed
+      description: Remaining subscription entitlements
       content:
         application/json:
           schema:
-            $ref: '../schemas/Entitlement/SubscriptionEntitlement.yaml'
+            $ref: '../schemas/Entitlement/SubscriptionEntitlements.yaml'
     '400':
       $ref: '../responses/BadRequest.yaml'
     '401':

src/resources/subscription_entitlements.yaml

@@ -31,7 +31,7 @@ patch:
   summary: Update subscription entitlements
   parameters:
     - $ref: "../parameters/subscription_status.yaml"
-  description: This accepts a list of entitlements to update. If the feature isn't part of the subscription yet, it's added with all the privileges from the payload. If the feature is already part of the subscription (via plan or via override), the privilege and values are updated or added. All privileges must be valid for the feature. All features  and privileges not part of the payload are left untouched. To remove privileges or features, use the DELETE endpoints.
+  description: This accepts a list of entitlements to update. If the feature isn't part of the subscription yet, it's added with all the privileges from the payload. If the feature is already part of the subscription (via plan or via override), the privilege and values are updated or added. All privileges must be valid for the feature. All features and privileges not part of the payload are left untouched. To remove privileges or features, use the DELETE endpoints.
   operationId: updateSubscriptionEntitlements
   requestBody:
     description: Subscription entitlements payload