REST API Ref: Add responses to PATCH /cart/{identifier}

Author: adriendupuis

docs/api/rest_api/rest_api_reference/input/ibexa-cart.raml

@@ -85,7 +85,7 @@ post:
             401:
                 description: Error - the user is not authorized to get this cart.
             404:
-                description: Error - The identifier do not match any Cart.
+                description: Error - the identifier do not match any cart.
     delete:
         displayName: Delete Cart
         description: Deletes Cart by its identifier.
@@ -98,11 +98,32 @@ post:
                 example: |
                     application/vnd.ibexa.api.CartMetadataUpdate+xml
                     application/vnd.ibexa.api.CartMetadataUpdate+json
+            Accept:
+                description: The Cart is returned in XML or JSON format.
+                example: |
+                    application/vnd.ibexa.api.Cart+xml
+                    application/vnd.ibexa.api.Cart+json
         body:
             application/vnd.ibexa.api.CartMetadataUpdate+xml:
                 type: CartMetadataUpdate
             application/vnd.ibexa.api.CartMetadataUpdate+json:
                 type: CartMetadataUpdateWrapper
+        responses:
+            200:
+                description: OK - return the updated cart
+                body:
+                    application/vnd.ibexa.api.Cart+xml:
+                        type: Cart
+                        example: !include examples/cart/POST/Cart.xml.example
+                    application/vnd.ibexa.api.Cart+json:
+                        type: CartWrapper
+                        example: !include examples/cart/POST/Cart.json.example
+            400:
+                description: Error - the input doesn't match the input schema definition.
+            401:
+                description: Error - the user is not authorized to update this cart.
+            404:
+                description: Error - the identifier doesn't match any cart.
     /entry:
         post:
             displayName: Add Entry to Cart