diff --git a/api/machines/models.mdx b/api/machines/models.mdx
index 2ac5c8513f..063ec7abf3 100644
--- a/api/machines/models.mdx
+++ b/api/machines/models.mdx
@@ -4,6 +4,11 @@ icon: boxes
 description: Schema reference for every object in the Fly Machines API.
 ---
 
+{/*
+  This file is generated by scripts/generate-machines-models.py in
+  superfly/nomad-firecracker from api/machines/openapi.json. Don't edit it
+  here: changes are overwritten when the Machines API spec changes.
+*/}
 
 These are the data models used across the Machines API requests and responses, generated from the OpenAPI specification.