diff --git a/oas_docs/bundle.json b/oas_docs/bundle.json
index 06ca2ad02c8b5..77ab3a69c84fb 100644
--- a/oas_docs/bundle.json
+++ b/oas_docs/bundle.json
@@ -21605,6 +21605,9 @@
                                     ],
                                     "type": "string"
                                   },
+                                  "reason": {
+                                    "type": "string"
+                                  },
                                   "retry_error_msg": {
                                     "type": "string"
                                   },
@@ -24271,6 +24274,9 @@
                                   ],
                                   "type": "string"
                                 },
+                                "reason": {
+                                  "type": "string"
+                                },
                                 "retry_error_msg": {
                                   "type": "string"
                                 },
@@ -24804,6 +24810,9 @@
                                   ],
                                   "type": "string"
                                 },
+                                "reason": {
+                                  "type": "string"
+                                },
                                 "retry_error_msg": {
                                   "type": "string"
                                 },
diff --git a/oas_docs/output/kibana.yaml b/oas_docs/output/kibana.yaml
index 962f6410ba1e5..846e0895e4b2b 100644
--- a/oas_docs/output/kibana.yaml
+++ b/oas_docs/output/kibana.yaml
@@ -31579,6 +31579,8 @@ paths:
                                     - UPG_WATCHING
                                     - UPG_ROLLBACK
                                   type: string
+                                reason:
+                                  type: string
                                 retry_error_msg:
                                   type: string
                                 retry_until:
@@ -32120,6 +32122,8 @@ paths:
                                   - UPG_WATCHING
                                   - UPG_ROLLBACK
                                 type: string
+                              reason:
+                                type: string
                               retry_error_msg:
                                 type: string
                               retry_until:
@@ -32517,6 +32521,8 @@ paths:
                                   - UPG_WATCHING
                                   - UPG_ROLLBACK
                                 type: string
+                              reason:
+                                type: string
                               retry_error_msg:
                                 type: string
                               retry_until:
diff --git a/x-pack/platform/plugins/shared/fleet/server/types/rest_spec/agent.ts b/x-pack/platform/plugins/shared/fleet/server/types/rest_spec/agent.ts
index e345235cd8609..0fa90c18896d2 100644
--- a/x-pack/platform/plugins/shared/fleet/server/types/rest_spec/agent.ts
+++ b/x-pack/platform/plugins/shared/fleet/server/types/rest_spec/agent.ts
@@ -241,6 +241,7 @@ export const AgentResponseSchema = schema.object({
             error_msg: schema.maybe(schema.string()),
             retry_error_msg: schema.maybe(schema.string()),
             retry_until: schema.maybe(schema.string()),
+            reason: schema.maybe(schema.string()),
           })
         ),
       }),