200 error message on disabled catalogs

Author: meganelepalud-akeneo

content/apps/catalogs.md

@@ -29,6 +29,20 @@ To ensure Akeneo PXM Studio remains stable, we added some limits to catalogs:
 - Each app can create up to **15 catalogs**.
 - A product selection can have up to **25 selection criteria**.
 
+### Troubleshooting
+
+#### Automatic deactivation on catalogs
+
+When a product selection becomes invalid, e.g. a selected category no longer exists, the PIM automatically disables the catalog. 
+
+In that case, your app receives an HTTP 200 response containing the following payload.
+
+```json
+{
+  "error": "No products to synchronize. The catalog \"65f5a521-e65c-4d7b-8be8-1f267fa2729c\" has been disabled on the PIM side. Note that you can get catalogs status with the GET /api/rest/v1/catalogs endpoint."
+}
+```
+
 
 ### Next steps
 

content/swagger/resources/app_catalogs/routes/app_catalogs_id_product_uuids.yaml

@@ -1,7 +1,8 @@
 get:
   summary: Get the list of product uuids
   operationId: "get_app_catalog_product_uuids"
-  description: Coming soon. This endpoint allows you to get the list of uuids of products contained in a catalog.
+  description: This endpoint allows you to get the list of uuids of products contained in a catalog. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message,
+    for more details see the <a href="apps/catalogs.html#troubleshooting">App Catalog</a> section.
   tags:
     - Catalog products
   x-versions:

content/swagger/resources/app_catalogs/routes/app_catalogs_id_products.yaml

@@ -5,7 +5,8 @@ get:
     - Catalog products
   x-versions:
     - "SaaS"
-  description: This endpoint allows you to get the list of products related to a catalog. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your app settings are applied to the set of products you request.
+  description: This endpoint allows you to get the list of products related to a catalog. Products are paginated and they can be filtered. In the Enterprise Edition, permissions based on your app settings are applied to the set of products you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message,
+    for more details see the <a href="apps/catalogs.html#troubleshooting">App Catalog</a> section.
   parameters:
     - name: id
       in: path

content/swagger/resources/app_catalogs/routes/app_catalogs_id_products_uuid.yaml

@@ -5,7 +5,8 @@ get:
     - Catalog products
   x-versions:
     - "SaaS"
-  description: This endpoint allows you to get a specific product related to a catalog. In the Enterprise Edition, permissions based on your app settings are applied on the product you request.
+  description: This endpoint allows you to get a specific product related to a catalog. In the Enterprise Edition, permissions based on your app settings are applied on the product you request. Please, note that a disabled catalog can return an HTTP 200 with a payload containing an error message,
+    for more details see the <a href="apps/catalogs.html#troubleshooting">App Catalog</a> section.
   parameters:
     - name: id
       in: path