detail error codes

specs/advanced-personalization/common/responses/BadRequest.yml

@@ -2,4 +2,13 @@ description: Bad request.
 content:
   application/json:
     schema:
-      $ref: './BaseResponse.yml'
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [400]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["Invalid request body"]

specs/advanced-personalization/common/responses/BadUserID.yml

@@ -0,0 +1,14 @@
+description: Invalid user ID format.
+content:
+  application/json:
+    schema:
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [400]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["Invalid userID format"]

specs/advanced-personalization/common/responses/GenericUnprocessableEntity.yml

@@ -0,0 +1,14 @@
+description: Unprocessable entity.
+content:
+  application/json:
+    schema:
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [422]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["Unprocessable Entity"]

specs/advanced-personalization/common/responses/InternalServerError.yml

@@ -2,4 +2,13 @@ description: Internal server error.
 content:
   application/json:
     schema:
-      $ref: './BaseResponse.yml'
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [500]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["Internal Server Error"]

specs/advanced-personalization/common/responses/InvalidUserID.yml

@@ -1,5 +1,14 @@
-description: Invalid user ID format.
+description: Invalid user token.
 content:
   application/json:
     schema:
-      $ref: './BaseResponse.yml'
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [422]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["UserID must contain only alphanumeric, equal, plus, slash, hyphen, or underscore characters, and be between 1 and 129 characters long"]

specs/advanced-personalization/common/responses/Unauthorized.yml

@@ -2,4 +2,13 @@ description: Not authorized to access this resource.
 content:
   application/json:
     schema:
-      $ref: './BaseResponse.yml'
+      type: object
+      properties:
+        status:
+          type: integer
+          description: HTTP status code.
+          enum: [401]
+        message:
+          type: string
+          description: Details about the response, such as error messages.
+          enum: ["Unauthorized"]

specs/advanced-personalization/common/responses/UserNotFound.yml

@@ -2,4 +2,11 @@ description: User not found.
 content:
   application/json:
     schema:
-      $ref: './BaseResponse.yml'
+      status:
+        type: integer
+        description: HTTP status code.
+        enum: [404]
+      message:
+        type: string
+        description: Details about the response, such as error messages.
+        enum: ["Not Found"]

specs/advanced-personalization/common/schemas/Configuration.yml

@@ -72,3 +72,5 @@ status:
       type: array
       items:
         $ref: '../enums.yml#/errorCodes'
+    lastUpdatedAt:
+      type: string

specs/advanced-personalization/paths/config.yml

@@ -17,8 +17,6 @@ get:
             $ref: '../common/schemas/ConfigurationObject.yml#/configurationObject'
     '401':
       $ref: '../common/responses/Unauthorized.yml'
-    '404':
-      $ref: '../common/responses/ConfigurationNotFound.yml'
     '500':
       $ref: '../common/responses/InternalServerError.yml'
 

specs/advanced-personalization/paths/user.yml

@@ -18,7 +18,7 @@ get:
           schema:
             $ref: '../common/schemas/User.yml#/user'
     '400':
-      $ref: '../common/responses/BadRequest.yml'
+      $ref: '../common/responses/BadUserID.yml'
     '401':
       $ref: '../common/responses/Unauthorized.yml'
     '404':
@@ -60,11 +60,9 @@ delete:
               deletedAt:
                 type: string
     '400':
-      $ref: '../common/responses/BadRequest.yml'
+      $ref: '../common/responses/BadUserID.yml'
     '401':
       $ref: '../common/responses/Unauthorized.yml'
-    '404':
-      $ref: '../common/responses/UserNotFound.yml'
     '422':
       $ref: '../common/responses/InvalidUserID.yml'
     '500':

specs/advanced-personalization/paths/users.yml

@@ -34,9 +34,9 @@ get:
               nextPageToken:
                 type: string
             required: [users]
-    '400':
-      $ref: '../common/responses/BadRequest.yml'
     '401':
       $ref: '../common/responses/Unauthorized.yml'
+    '422':
+      $ref: '../common/responses/GenericUnprocessableEntity.yml'
     '500':
       $ref: '../common/responses/InternalServerError.yml'