major update

docs/openapi.yaml

@@ -62,10 +62,16 @@ paths:
               examples:
                 invalid_credentials:
                   value:
-                    error: invalid_credentials
+                    ok: false
+                    request_id: 550e8400-e29b-41d4-a716-446655440000
+                    error_code: invalid_credentials
+                    details: {}
                 account_inactive:
                   value:
-                    error: account_inactive
+                    ok: false
+                    request_id: 550e8400-e29b-41d4-a716-446655440000
+                    error_code: account_inactive
+                    details: {}
         '403':
           $ref: '#/components/responses/Forbidden'
         '409':
@@ -1108,7 +1114,10 @@ components:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
           example:
-            error: unauthorized
+            ok: false
+            request_id: 550e8400-e29b-41d4-a716-446655440000
+            error_code: unauthorized
+            details: {}
     Forbidden:
       description: Forbidden
       content:
@@ -1122,7 +1131,10 @@ components:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
           example:
-            error: not_found
+            ok: false
+            request_id: 550e8400-e29b-41d4-a716-446655440000
+            error_code: not_found
+            details: {}
     ValidationError:
       description: Validation failed
       content:
@@ -1130,10 +1142,13 @@ components:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
           example:
-            error: validation_error
-            errors:
-              field:
-                - invalid_value
+            ok: false
+            request_id: 550e8400-e29b-41d4-a716-446655440000
+            error_code: validation_error
+            details:
+              errors:
+                field:
+                  - invalid_value
     Conflict:
       description: Conflict
       content:
@@ -1151,7 +1166,11 @@ components:
           schema:
             $ref: '#/components/schemas/ErrorResponse'
           example:
-            error: rate_limit_exceeded
+            ok: false
+            request_id: 550e8400-e29b-41d4-a716-446655440000
+            error_code: rate_limit_exceeded
+            details:
+              retry_after: 60
     ServerError:
       description: Internal server error
       content:
@@ -1167,16 +1186,19 @@ components:
   schemas:
     ErrorResponse:
       type: object
-      required: [error]
+      required: [ok, request_id, error_code, details]
       properties:
-        error:
+        ok:
+          type: boolean
+          example: false
+        request_id:
           type: string
-        errors:
+          format: uuid
+        error_code:
+          type: string
+        details:
           type: object
-          additionalProperties:
-            type: array
-            items:
-              type: string
+          additionalProperties: true
     GenericDataResponse:
       type: object
       required: [data]
@@ -1333,6 +1355,11 @@ components:
         user_inactivity_delete_days:
           type: integer
           nullable: true
+        system_audit_enabled:
+          type: boolean
+        system_audit_retention_days:
+          type: integer
+          nullable: true
         microsoft_shared_client_id:
           type: string
         microsoft_authority:
@@ -1395,6 +1422,11 @@ components:
         user_inactivity_delete_days:
           type: integer
           nullable: true
+        system_audit_enabled:
+          type: boolean
+        system_audit_retention_days:
+          type: integer
+          nullable: true
         microsoft_shared_client_id:
           type: string
         microsoft_authority: