diff --git a/api/README.md b/api/README.md
index a965e679ee..ccbb7fc2e7 100644
--- a/api/README.md
+++ b/api/README.md
@@ -1,9 +1,8 @@
 # Docker Swarm API README
 
 The Docker Swarm API is mostly compatible with the [Docker Remote
-API](https://docs.docker.com/reference/api/docker_remote_api/).  To read the
-end-user API documentation, visit [the Swarm API documentation on
-docs.docker.com](https://docs.docker.com/swarm/api/swarm-api/). If you want to
-modify the discovery API documentation, start with [the `docs/api/swarm-api.md`
-file](https://github.com/docker/swarm/blob/master/docs/api/swarm-api.md) in this
-project.
+API](https://docs.docker.com/engine/reference/api/docker_remote_api/). To read
+the end-user API documentation, visit [the Swarm API documentation on
+docs.docker.com](https://docs.docker.com/swarm/swarm-api/). If you want to
+modify the discovery API documentation, start with [the `docs/swarm-api.md`
+file](../docs/swarm-api.md) in this project.