feat: wire image field through API for custom image pinning per database or node

api/apiv1/design/database.go

@@ -1093,6 +1093,10 @@ var CreateDatabaseResponse = g.Type("CreateDatabaseResponse", func() {
 		g.Description("The database being created.")
 		g.Meta("struct:tag:json", "database")
 	})
+	g.Attribute("warnings", g.ArrayOf(g.String), func() {
+		g.Description("Non-fatal warnings generated during spec validation, e.g. when a custom image override is not found in the version manifest.")
+		g.Meta("struct:tag:json", "warnings,omitempty")
+	})
 
 	g.Required("task", "database")
 
@@ -1242,6 +1246,10 @@ var UpdateDatabaseResponse = g.Type("UpdateDatabaseResponse", func() {
 		g.Description("The database being updated.")
 		g.Meta("struct:tag:json", "database")
 	})
+	g.Attribute("warnings", g.ArrayOf(g.String), func() {
+		g.Description("Non-fatal warnings generated during spec validation, e.g. when a custom image override is not found in the version manifest.")
+		g.Meta("struct:tag:json", "warnings,omitempty")
+	})
 
 	g.Required("task", "database")
 
@@ -1949,6 +1957,14 @@ var SwarmOpts = g.Type("SwarmOpts", func() {
 		})
 		g.Meta("struct:tag:json", "extra_labels,omitempty")
 	})
+	g.Attribute("image", g.String, func() {
+		g.Description("User-specified container image override. Bypasses manifest version " +
+			"constraints entirely — the CP will deploy this image without validating it against " +
+			"the version manifest. A warning is returned if the image is not found in the manifest. " +
+			"Clearing this field causes the CP to fall back to the manifest-resolved image on the " +
+			"next reconcile.")
+		g.Meta("struct:tag:json", "image,omitempty")
+	})
 })
 
 var OrchestratorOpts = g.Type("OrchestratorOpts", func() {