diff --git a/docs/api/swarm-api.md b/docs/api/swarm-api.md
index d4e5e5fcc8..cc23ee4773 100644
--- a/docs/api/swarm-api.md
+++ b/docs/api/swarm-api.md
@@ -42,6 +42,8 @@ POST "/images/create" : "docker import" flow not implement
 
 * `GET "/images/json"` : Use '--filter node=\<Node name\>' to show images of the specific node.
 
+* `POST "/containers/create"`: `CpuShares` in `HostConfig` sets the number of CPU cores allocated to the container.
+
 ## Docker Swarm documentation index
 
 - [User guide](https://docs.docker.com/swarm/)