@@ -2449,7 +2449,15 @@ definitions:

     properties:

       PluginSpec:

         type: "object"

-        description: "Invalid when specified with `ContainerSpec`. *(Experimental release only.)*"

+        description: |

+          Plugin spec for the service.  *(Experimental release only.)*

+

+          <p><br /></p>

+

+          > **Note**: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are

+          > mutually exclusive. PluginSpec is only used when the Runtime field

+          > is set to `plugin`. NetworkAttachmentSpec is used when the Runtime

+          > field is set to `attachment`.

         properties:

           Name:

             description: "The name or 'alias' to use for the plugin."

@@ -2476,7 +2484,15 @@ definitions:

                     type: "string"

       ContainerSpec:

         type: "object"

-        description: "Invalid when specified with `PluginSpec`."

+        description: |

+          Container spec for the service.

+

+          <p><br /></p>

+

+          > **Note**: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are

+          > mutually exclusive. PluginSpec is only used when the Runtime field

+          > is set to `plugin`. NetworkAttachmentSpec is used when the Runtime

+          > field is set to `attachment`.

         properties:

           Image:

             description: "The image name to use for the container"

@@ -2689,7 +2705,16 @@ definitions:

               - "process"

               - "hyperv"

       NetworkAttachmentSpec:

-        description: "Read-only spec type for non-swarm containers attached to swarm overlay networks"

+        description: |

+          Read-only spec type for non-swarm containers attached to swarm overlay

+          networks.

+

+          <p><br /></p>

+

+          > **Note**: ContainerSpec, NetworkAttachmentSpec, and PluginSpec are

+          > mutually exclusive. PluginSpec is only used when the Runtime field

+          > is set to `plugin`. NetworkAttachmentSpec is used when the Runtime

+          > field is set to `attachment`.

         type: "object"

         properties:

           ContainerID:

@@ -13,6 +13,12 @@ keywords: "API, Docker, rcli, REST, documentation"

      will be rejected.

 -->

+## V1.38 API changes

+

+* `GET /tasks` and `GET /tasks/{id}` now return a `NetworkAttachmentSpec` field,

+  containing the `ContainerID` for non-service containers connected to "attachable"

+  swarm-scoped networks.

+

 ## v1.37 API changes

 [Docker Engine API v1.37](https://docs.docker.com/engine/api/v1.37/) documentation