diff --git a/api/swagger.yaml b/api/swagger.yaml
index 08e4e66d3b..16da2ce491 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -2234,6 +2234,10 @@ definitions:
       password:
         type: "string"
       email:
+        description: |
+          Email is an optional value associated with the username.
+
+          > **Deprecated**: This field is deprecated since docker 1.11 (API v1.23) and will be removed in a future release.
         type: "string"
       serveraddress:
         type: "string"
diff --git a/api/types/registry/authconfig.go b/api/types/registry/authconfig.go
index fa9037bdad..4c6d7ab2ba 100644
--- a/api/types/registry/authconfig.go
+++ b/api/types/registry/authconfig.go
@@ -32,8 +32,8 @@ type AuthConfig struct {
 	Auth     string `json:"auth,omitempty"`
 
 	// Email is an optional value associated with the username.
-	// This field is deprecated and will be removed in a later
-	// version of docker.
+	//
+	// Deprecated: This field is deprecated since docker 1.11 (API v1.23) and will be removed in the next release.
 	Email string `json:"email,omitempty"`
 
 	ServerAddress string `json:"serveraddress,omitempty"`
diff --git a/docs/api/v1.51.yaml b/docs/api/v1.51.yaml
index 08e4e66d3b..16da2ce491 100644
--- a/docs/api/v1.51.yaml
+++ b/docs/api/v1.51.yaml
@@ -2234,6 +2234,10 @@ definitions:
       password:
         type: "string"
       email:
+        description: |
+          Email is an optional value associated with the username.
+
+          > **Deprecated**: This field is deprecated since docker 1.11 (API v1.23) and will be removed in a future release.
         type: "string"
       serveraddress:
         type: "string"