diff --git a/openapi/api-docs.yaml b/openapi/api-docs.yaml
index 78e22091e5..e2a2198cf1 100644
--- a/openapi/api-docs.yaml
+++ b/openapi/api-docs.yaml
@@ -16709,11 +16709,11 @@ components:
     Error:
       properties:
         message:
-          description: 'The company name'
+          description: 'Something terrible went wrong'
           type: string
           example: 'Unexpected error'
         code:
-          description: 'The HTTP error code'
+          description: 'The HTTP error code, ie 5xx 4xx'
           type: integer
           example: '500'
       type: object
diff --git a/openapi/components/components.yaml b/openapi/components/components.yaml
index 15f974c585..9af85339d0 100644
--- a/openapi/components/components.yaml
+++ b/openapi/components/components.yaml
@@ -1838,11 +1838,11 @@ components:
     Error:
       properties:
         message:
-          description: 'The company name'
+          description: 'Something terrible went wrong'
           type: string
           example: 'Unexpected error'
         code:
-          description: 'The HTTP error code'
+          description: 'The HTTP error code, ie 5xx 4xx'
           type: integer
           example: '500'
       type: object