diff --git a/api/swagger.yaml b/api/swagger.yaml
index ffbeffb2ce..753dcb267e 100644
--- a/api/swagger.yaml
+++ b/api/swagger.yaml
@@ -7138,6 +7138,10 @@ paths:
             example:
               ID: "ak7w3gjqoa3kuz8xcpnyy0pvl"
               Warning: "unable to pin image doesnotexist:latest to digest: image library/doesnotexist:latest not found"
+        403:
+          description: "network is not eligible for services"
+          schema:
+            $ref: "#/definitions/ErrorResponse"
         409:
           description: "name conflicts with an existing service"
           schema:
diff --git a/docs/api/v1.24.md b/docs/api/v1.24.md
index 81479c083e..704ba8c011 100644
--- a/docs/api/v1.24.md
+++ b/docs/api/v1.24.md
@@ -4563,6 +4563,11 @@ image](#create-an-image) section for more details.
           ],
           "User": "33"
         },
+        "Networks": [
+            {
+              "Target": "overlay1"
+            }
+        ],
         "LogDriver": {
           "Name": "json-file",
           "Options": {
@@ -4620,6 +4625,7 @@ image](#create-an-image) section for more details.
 **Status codes**:
 
 -   **201** – no error
+-   **403** - network is not eligible for services
 -   **406** – node is not part of a swarm
 -   **409** – name conflicts with an existing object
 -   **500** - server error