Some swagger updates

Author: jameslinnell

infrastructure/swagger/05_paths.yaml

@@ -356,7 +356,7 @@ paths:
         "200":
           $ref: "#/components/responses/ProductRead"
         "404":
-          $ref: "#/components/responses/NotFound"
+          $ref: "#/components/responses/ProductNotFound"
       x-amazon-apigateway-integration:
         <<: *ApiGatewayIntegration
         uri: ${method_readCpmProduct}

infrastructure/swagger/07_components--schemas--domain.yaml

@@ -183,7 +183,7 @@ components:
           - org_code: "xyzzy"
             product_teams:
               - product_team_id: "55e86121-3826-468c-a6f0-dd0f1fbc0259"
-              - cpm_product_team_id: "a9a9694d-001b-45ce-9f2a-6c9bf80ae0d0"
+                cpm_product_team_id: "a9a9694d-001b-45ce-9f2a-6c9bf80ae0d0"
                 products:
                   - id: "P.123"
                     product_team_id: "1234"
@@ -195,7 +195,7 @@ components:
                     deleted_on: "null"
                     keys: []
               - product_team_id: "24ac1857-f718-4905-813f-52da930c3ea1"
-              - cpm_product_team_id: "152705aa-0342-487f-a654-64bba814a847"
+                cpm_product_team_id: "152705aa-0342-487f-a654-64bba814a847"
                 products:
                   - id: "P.xyz"
                     product_team_id: "5678"

infrastructure/swagger/12_components--responses.yaml

@@ -40,6 +40,16 @@ components:
             errors:
               - code: "RESOURCE_NOT_FOUND"
                 message: "Could not find ProductTeam for key ('f9518c12-6c83-4544-97db-d9dd1d64da97')"
+    ProductNotFound:
+      description: Product has not been found
+      content:
+        application/json:
+          schema:
+            $ref: "#/components/schemas/ErrorResponse"
+          example:
+            errors:
+              - code: "RESOURCE_NOT_FOUND"
+                message: "Could not find CpmProduct for key ('P.XXX-YYY')"
     Conflict:
       description: Conflict
       content:

infrastructure/swagger/13_components--parameters--query.yaml

@@ -5,7 +5,7 @@ components:
       name: product_team_id
       in: query
       required: false
-      description: The ID of the product team to filter results by.
+      description: Product Team identifier to filter results by. Either the "internally" generated id (cpm_product_team_id) or the provided team id (product_team_id)
       schema:
         type: string
     OrganisationCodeQuery: