diff --git a/changes/3628.feat.md b/changes/3628.feat.md
new file mode 100644
index 0000000000..1962476a56
--- /dev/null
+++ b/changes/3628.feat.md
@@ -0,0 +1 @@
+Update `ForgetImageById` to perform soft delete and added `PurgeImageById` API for hard delete.
\ No newline at end of file
diff --git a/docs/manager/graphql-reference/schema.graphql b/docs/manager/graphql-reference/schema.graphql
index 850534fc59..cc09f11b3f 100644
--- a/docs/manager/graphql-reference/schema.graphql
+++ b/docs/manager/graphql-reference/schema.graphql
@@ -1829,6 +1829,12 @@ type Mutations {
   forget_image_by_id(image_id: String!): ForgetImageById
   forget_image(architecture: String = "x86_64", reference: String!): ForgetImage
 
+  """Added in 25.3.0"""
+  purge_image_by_id(image_id: String!): PurgeImageById
+
+  """Added in 25.3.0"""
+  purge_image(architecture: String = "x86_64", reference: String!): PurgeImage
+
   """Added in 24.03.1"""
   untag_image_from_registry(image_id: String!): UntagImageFromRegistry
   alias_image(alias: String!, architecture: String = "x86_64", target: String!): AliasImage
@@ -2354,6 +2360,19 @@ type ForgetImage {
   image: ImageNode
 }
 
+"""Added in 25.3.0."""
+type PurgeImageById {
+  ok: Boolean
+  msg: String
+  image: ImageNode
+}
+
+type PurgeImage {
+  ok: Boolean
+  msg: String
+  image: ImageNode
+}
+
 """Added in 24.03.1"""
 type UntagImageFromRegistry {
   ok: Boolean