Browse code

Deprecate API calls without a version

See #21157 for more details.

In a future version of Docker, providing a version to API calls
will be mandatory. An implementation of this is in #27801.

Signed-off-by: Ben Firshman <ben@firshman.co.uk>

Ben Firshman authored on 2016/10/28 01:59:59
Showing 10 changed files
... ...
@@ -226,3 +226,12 @@ Since 1.9, Docker Content Trust Offline key has been renamed to Root key and the
226 226
 **Deprecated In Release: v1.13.0**
227 227
 
228 228
 `MAINTAINER` was an early very limited form of `LABEL` which should be used instead.
229
+
230
+### API calls without a version
231
+**Deprecated In Release: [v1.13](https://github.com/docker/docker/releases/)**
232
+
233
+**Target For Removal In Release: v1.16**
234
+
235
+API versions should be supplied to all API calls to ensure compatibility with
236
+future Engine versions. Instead of just requesting, for example, the URL
237
+`/containers/json`, you must now request `/v1.25/containers/json`.
... ...
@@ -36,23 +36,34 @@ following:
36 36
 When using cUrl 7.50 or later:
37 37
 
38 38
 ```console
39
-$ curl --unix-socket /var/run/docker.sock http://localhost/containers/json
39
+$ curl --unix-socket /var/run/docker.sock http://localhost/v1.25/containers/json
40 40
 ```
41 41
 
42 42
 When using cURL 7.40, `localhost` must be omitted:
43 43
 
44 44
 ```console
45
-$ curl --unix-socket /var/run/docker.sock http://containers/json
45
+$ curl --unix-socket /var/run/docker.sock http://v1.25/containers/json
46 46
 ```
47 47
 
48 48
 If you have bound the Docker daemon to a different socket path or TCP
49 49
 port, you would reference that in your cURL rather than the
50 50
 default.
51 51
 
52
-The current version of the API is v1.25 which means calling `/info` is the same
53
-as calling `/v1.25/info`. To call an older version of the API use
54
-`/v1.24/info`. If a newer daemon is installed, new properties may be returned
55
-even when calling older versions of the API.
52
+## Versioning
53
+
54
+It is required to to supply a version to API calls. This is done by prefixing
55
+the URL with the version number.
56
+
57
+The current version of the API is 1.25, so to call the `/info` endpoint, you
58
+would send a request to the URL `/v1.25/info`. To call, for example, version
59
+1.24 of the API instead, you would request `/v1.24/info`.
60
+
61
+If a newer daemon is installed, new properties may be returned even when
62
+calling older versions of the API.
63
+
64
+In previous versions of Docker, it was possible to access the API without
65
+providing a version. This behaviour is now deprecated will be removed in a
66
+future version of Docker.
56 67
 
57 68
 Use the table below to find the API version for a Docker version:
58 69
 
... ...
@@ -97,11 +108,11 @@ API requests, for example:
97 97
 curl --insecure \
98 98
      --cert $DOCKER_CERT_PATH/cert.pem \
99 99
      --key $DOCKER_CERT_PATH/key.pem \
100
-     https://YOUR_VM_IP:2376/images/json
100
+     https://YOUR_VM_IP:2376/v1.25/images/json
101 101
 
102 102
 wget --no-check-certificate --certificate=$DOCKER_CERT_PATH/cert.pem \
103 103
      --private-key=$DOCKER_CERT_PATH/key.pem \
104
-     https://YOUR_VM_IP:2376/images/json -O - -q
104
+     https://YOUR_VM_IP:2376/v1.25/images/json -O - -q
105 105
 ```
106 106
 
107 107
 ## Docker Events
... ...
@@ -130,6 +141,7 @@ This section lists each version from latest to oldest.  Each listing includes a
130 130
 
131 131
 [Docker Remote API v1.25](docker_remote_api_v1.25.md) documentation
132 132
 
133
+* The API version is now required in all API calls. Instead of just requesting, for example, the URL `/containers/json`, you must now request `/v1.25/containers/json`.
133 134
 * `GET /version` now returns `MinAPIVersion`.
134 135
 * `POST /build` accepts `networkmode` parameter to specify network used during build.
135 136
 * `GET /images/(name)/json` now returns `OsVersion` if populated
... ...
@@ -36,7 +36,7 @@ List containers
36 36
 
37 37
 **Example request**:
38 38
 
39
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
39
+    GET /v1.18/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
40 40
 
41 41
 **Example response**:
42 42
 
... ...
@@ -129,7 +129,7 @@ Create a container
129 129
 
130 130
 **Example request**:
131 131
 
132
-    POST /containers/create HTTP/1.1
132
+    POST /v1.18/containers/create HTTP/1.1
133 133
     Content-Type: application/json
134 134
 
135 135
     {
... ...
@@ -316,7 +316,7 @@ Return low-level information on the container `id`
316 316
 
317 317
 **Example request**:
318 318
 
319
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
319
+      GET /v1.18/containers/4fa6e0f0c678/json HTTP/1.1
320 320
 
321 321
 **Example response**:
322 322
 
... ...
@@ -451,7 +451,7 @@ supported on Windows.
451 451
 
452 452
 **Example request**:
453 453
 
454
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
454
+    GET /v1.18/containers/4fa6e0f0c678/top HTTP/1.1
455 455
 
456 456
 **Example response**:
457 457
 
... ...
@@ -474,7 +474,7 @@ supported on Windows.
474 474
 
475 475
 **Example request**:
476 476
 
477
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
477
+    GET /v1.18/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
478 478
 
479 479
 **Example response**:
480 480
 
... ...
@@ -516,7 +516,7 @@ Get `stdout` and `stderr` logs from the container ``id``
516 516
 
517 517
 **Example request**:
518 518
 
519
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10 HTTP/1.1
519
+     GET /v1.18/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10 HTTP/1.1
520 520
 
521 521
 **Example response**:
522 522
 
... ...
@@ -553,7 +553,7 @@ Inspect changes on container `id`'s filesystem
553 553
 
554 554
 **Example request**:
555 555
 
556
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
556
+    GET /v1.18/containers/4fa6e0f0c678/changes HTTP/1.1
557 557
 
558 558
 **Example response**:
559 559
 
... ...
@@ -595,7 +595,7 @@ Export the contents of container `id`
595 595
 
596 596
 **Example request**:
597 597
 
598
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
598
+    GET /v1.18/containers/4fa6e0f0c678/export HTTP/1.1
599 599
 
600 600
 **Example response**:
601 601
 
... ...
@@ -620,7 +620,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
620 620
 
621 621
 **Example request**:
622 622
 
623
-    GET /containers/redis1/stats HTTP/1.1
623
+    GET /v1.18/containers/redis1/stats HTTP/1.1
624 624
 
625 625
 **Example response**:
626 626
 
... ...
@@ -708,7 +708,7 @@ Resize the TTY for container with  `id`. You must restart the container for the
708 708
 
709 709
 **Example request**:
710 710
 
711
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
711
+      POST /v1.18/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
712 712
 
713 713
 **Example response**:
714 714
 
... ...
@@ -739,7 +739,7 @@ Start the container `id`
739 739
 
740 740
 **Example request**:
741 741
 
742
-    POST /containers/e90e34656806/start HTTP/1.1
742
+    POST /v1.18/containers/e90e34656806/start HTTP/1.1
743 743
 
744 744
 **Example response**:
745 745
 
... ...
@@ -760,7 +760,7 @@ Stop the container `id`
760 760
 
761 761
 **Example request**:
762 762
 
763
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
763
+    POST /v1.18/containers/e90e34656806/stop?t=5 HTTP/1.1
764 764
 
765 765
 **Example response**:
766 766
 
... ...
@@ -785,7 +785,7 @@ Restart the container `id`
785 785
 
786 786
 **Example request**:
787 787
 
788
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
788
+    POST /v1.18/containers/e90e34656806/restart?t=5 HTTP/1.1
789 789
 
790 790
 **Example response**:
791 791
 
... ...
@@ -809,7 +809,7 @@ Kill the container `id`
809 809
 
810 810
 **Example request**:
811 811
 
812
-    POST /containers/e90e34656806/kill HTTP/1.1
812
+    POST /v1.18/containers/e90e34656806/kill HTTP/1.1
813 813
 
814 814
 **Example response**:
815 815
 
... ...
@@ -834,7 +834,7 @@ Rename the container `id` to a `new_name`
834 834
 
835 835
 **Example request**:
836 836
 
837
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
837
+    POST /v1.18/containers/e90e34656806/rename?name=new_name HTTP/1.1
838 838
 
839 839
 **Example response**:
840 840
 
... ...
@@ -859,7 +859,7 @@ Pause the container `id`
859 859
 
860 860
 **Example request**:
861 861
 
862
-    POST /containers/e90e34656806/pause HTTP/1.1
862
+    POST /v1.18/containers/e90e34656806/pause HTTP/1.1
863 863
 
864 864
 **Example response**:
865 865
 
... ...
@@ -879,7 +879,7 @@ Unpause the container `id`
879 879
 
880 880
 **Example request**:
881 881
 
882
-    POST /containers/e90e34656806/unpause HTTP/1.1
882
+    POST /v1.18/containers/e90e34656806/unpause HTTP/1.1
883 883
 
884 884
 **Example response**:
885 885
 
... ...
@@ -899,7 +899,7 @@ Attach to the container `id`
899 899
 
900 900
 **Example request**:
901 901
 
902
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
902
+    POST /v1.18/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
903 903
 
904 904
 **Example response**:
905 905
 
... ...
@@ -986,7 +986,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
986 986
 
987 987
 **Example request**
988 988
 
989
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
989
+    GET /v1.18/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
990 990
 
991 991
 **Example response**
992 992
 
... ...
@@ -1021,7 +1021,7 @@ Block until container `id` stops, then returns the exit code
1021 1021
 
1022 1022
 **Example request**:
1023 1023
 
1024
-    POST /containers/16253994b7c4/wait HTTP/1.1
1024
+    POST /v1.18/containers/16253994b7c4/wait HTTP/1.1
1025 1025
 
1026 1026
 **Example response**:
1027 1027
 
... ...
@@ -1073,7 +1073,7 @@ Copy files or folders of container `id`
1073 1073
 
1074 1074
 **Example request**:
1075 1075
 
1076
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1076
+    POST /v1.18/containers/4fa6e0f0c678/copy HTTP/1.1
1077 1077
     Content-Type: application/json
1078 1078
 
1079 1079
     {
... ...
@@ -1103,7 +1103,7 @@ Copy files or folders of container `id`
1103 1103
 
1104 1104
 **Example request**:
1105 1105
 
1106
-    GET /images/json?all=0 HTTP/1.1
1106
+    GET /v1.18/images/json?all=0 HTTP/1.1
1107 1107
 
1108 1108
 **Example response**:
1109 1109
 
... ...
@@ -1137,7 +1137,7 @@ Copy files or folders of container `id`
1137 1137
 
1138 1138
 **Example request, with digest information**:
1139 1139
 
1140
-    GET /images/json?digests=1 HTTP/1.1
1140
+    GET /v1.18/images/json?digests=1 HTTP/1.1
1141 1141
 
1142 1142
 **Example response, with digest information**:
1143 1143
 
... ...
@@ -1191,7 +1191,7 @@ Build an image from a Dockerfile
1191 1191
 
1192 1192
 **Example request**:
1193 1193
 
1194
-    POST /build HTTP/1.1
1194
+    POST /v1.18/build HTTP/1.1
1195 1195
 
1196 1196
     {% raw %}
1197 1197
     {{ TAR STREAM }}
... ...
@@ -1262,7 +1262,7 @@ Create an image either by pulling it from the registry or by importing it
1262 1262
 
1263 1263
 **Example request**:
1264 1264
 
1265
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1265
+    POST /v1.18/images/create?fromImage=busybox&tag=latest HTTP/1.1
1266 1266
 
1267 1267
 **Example response**:
1268 1268
 
... ...
@@ -1306,7 +1306,7 @@ Return low-level information on the image `name`
1306 1306
 
1307 1307
 **Example request**:
1308 1308
 
1309
-    GET /images/ubuntu/json HTTP/1.1
1309
+    GET /v1.18/images/ubuntu/json HTTP/1.1
1310 1310
 
1311 1311
 **Example response**:
1312 1312
 
... ...
@@ -1357,7 +1357,7 @@ Return the history of the image `name`
1357 1357
 
1358 1358
 **Example request**:
1359 1359
 
1360
-    GET /images/ubuntu/history HTTP/1.1
1360
+    GET /v1.18/images/ubuntu/history HTTP/1.1
1361 1361
 
1362 1362
 **Example response**:
1363 1363
 
... ...
@@ -1391,7 +1391,7 @@ Push the image `name` on the registry
1391 1391
 
1392 1392
 **Example request**:
1393 1393
 
1394
-    POST /images/test/push HTTP/1.1
1394
+    POST /v1.18/images/test/push HTTP/1.1
1395 1395
 
1396 1396
 **Example response**:
1397 1397
 
... ...
@@ -1409,7 +1409,7 @@ then be used in the URL. This duplicates the command line's flow.
1409 1409
 
1410 1410
 **Example request**:
1411 1411
 
1412
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
1412
+    POST /v1.18/images/registry.acme.com:5000/test/push HTTP/1.1
1413 1413
 
1414 1414
 
1415 1415
 **Query parameters**:
... ...
@@ -1434,7 +1434,7 @@ Tag the image `name` into a repository
1434 1434
 
1435 1435
 **Example request**:
1436 1436
 
1437
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1437
+    POST /v1.18/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1438 1438
 
1439 1439
 **Example response**:
1440 1440
 
... ...
@@ -1499,7 +1499,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
1499 1499
 
1500 1500
 **Example request**:
1501 1501
 
1502
-    GET /images/search?term=sshd HTTP/1.1
1502
+    GET /v1.18/images/search?term=sshd HTTP/1.1
1503 1503
 
1504 1504
 **Example response**:
1505 1505
 
... ...
@@ -1550,7 +1550,7 @@ Get the default username and email
1550 1550
 
1551 1551
 **Example request**:
1552 1552
 
1553
-    POST /auth HTTP/1.1
1553
+    POST /v1.18/auth HTTP/1.1
1554 1554
     Content-Type: application/json
1555 1555
 
1556 1556
     {
... ...
@@ -1578,7 +1578,7 @@ Display system-wide information
1578 1578
 
1579 1579
 **Example request**:
1580 1580
 
1581
-    GET /info HTTP/1.1
1581
+    GET /v1.18/info HTTP/1.1
1582 1582
 
1583 1583
 **Example response**:
1584 1584
 
... ...
@@ -1643,7 +1643,7 @@ Show the docker version information
1643 1643
 
1644 1644
 **Example request**:
1645 1645
 
1646
-    GET /version HTTP/1.1
1646
+    GET /v1.18/version HTTP/1.1
1647 1647
 
1648 1648
 **Example response**:
1649 1649
 
... ...
@@ -1673,7 +1673,7 @@ Ping the docker server
1673 1673
 
1674 1674
 **Example request**:
1675 1675
 
1676
-    GET /_ping HTTP/1.1
1676
+    GET /v1.18/_ping HTTP/1.1
1677 1677
 
1678 1678
 **Example response**:
1679 1679
 
... ...
@@ -1695,7 +1695,7 @@ Create a new image from a container's changes
1695 1695
 
1696 1696
 **Example request**:
1697 1697
 
1698
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1698
+    POST /v1.18/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1699 1699
     Content-Type: application/json
1700 1700
 
1701 1701
     {
... ...
@@ -1902,7 +1902,7 @@ Sets up an exec instance in a running container `id`
1902 1902
 
1903 1903
 **Example request**:
1904 1904
 
1905
-    POST /containers/e90e34656806/exec HTTP/1.1
1905
+    POST /v1.18/containers/e90e34656806/exec HTTP/1.1
1906 1906
     Content-Type: application/json
1907 1907
 
1908 1908
     {
... ...
@@ -1947,7 +1947,7 @@ interactive session with the `exec` command.
1947 1947
 
1948 1948
 **Example request**:
1949 1949
 
1950
-    POST /exec/e90e34656806/start HTTP/1.1
1950
+    POST /v1.18/exec/e90e34656806/start HTTP/1.1
1951 1951
     Content-Type: application/json
1952 1952
 
1953 1953
     {
... ...
@@ -1987,7 +1987,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
1987 1987
 
1988 1988
 **Example request**:
1989 1989
 
1990
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
1990
+    POST /v1.18/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
1991 1991
     Content-Type: text/plain
1992 1992
 
1993 1993
 **Example response**:
... ...
@@ -2013,7 +2013,7 @@ Return low-level information about the `exec` command `id`.
2013 2013
 
2014 2014
 **Example request**:
2015 2015
 
2016
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2016
+    GET /v1.18/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2017 2017
 
2018 2018
 **Example response**:
2019 2019
 
... ...
@@ -38,7 +38,7 @@ List containers
38 38
 
39 39
 **Example request**:
40 40
 
41
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
41
+    GET /v1.19/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
42 42
 
43 43
 **Example response**:
44 44
 
... ...
@@ -131,7 +131,7 @@ Create a container
131 131
 
132 132
 **Example request**:
133 133
 
134
-    POST /containers/create HTTP/1.1
134
+    POST /v1.19/containers/create HTTP/1.1
135 135
     Content-Type: application/json
136 136
 
137 137
     {
... ...
@@ -328,7 +328,7 @@ Return low-level information on the container `id`
328 328
 
329 329
 **Example request**:
330 330
 
331
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
331
+      GET /v1.19/containers/4fa6e0f0c678/json HTTP/1.1
332 332
 
333 333
 **Example response**:
334 334
 
... ...
@@ -467,7 +467,7 @@ supported on Windows.
467 467
 
468 468
 **Example request**:
469 469
 
470
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
470
+    GET /v1.19/containers/4fa6e0f0c678/top HTTP/1.1
471 471
 
472 472
 **Example response**:
473 473
 
... ...
@@ -490,7 +490,7 @@ supported on Windows.
490 490
 
491 491
 **Example request**:
492 492
 
493
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
493
+    GET /v1.19/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
494 494
 
495 495
 **Example response**:
496 496
 
... ...
@@ -532,7 +532,7 @@ Get `stdout` and `stderr` logs from the container ``id``
532 532
 
533 533
 **Example request**:
534 534
 
535
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
535
+     GET /v1.19/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
536 536
 
537 537
 **Example response**:
538 538
 
... ...
@@ -571,7 +571,7 @@ Inspect changes on container `id`'s filesystem
571 571
 
572 572
 **Example request**:
573 573
 
574
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
574
+    GET /v1.19/containers/4fa6e0f0c678/changes HTTP/1.1
575 575
 
576 576
 **Example response**:
577 577
 
... ...
@@ -613,7 +613,7 @@ Export the contents of container `id`
613 613
 
614 614
 **Example request**:
615 615
 
616
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
616
+    GET /v1.19/containers/4fa6e0f0c678/export HTTP/1.1
617 617
 
618 618
 **Example response**:
619 619
 
... ...
@@ -638,7 +638,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
638 638
 
639 639
 **Example request**:
640 640
 
641
-    GET /containers/redis1/stats HTTP/1.1
641
+    GET /v1.19/containers/redis1/stats HTTP/1.1
642 642
 
643 643
 **Example response**:
644 644
 
... ...
@@ -747,7 +747,7 @@ Resize the TTY for container with  `id`. You must restart the container for the
747 747
 
748 748
 **Example request**:
749 749
 
750
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
750
+      POST /v1.19/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
751 751
 
752 752
 **Example response**:
753 753
 
... ...
@@ -778,7 +778,7 @@ Start the container `id`
778 778
 
779 779
 **Example request**:
780 780
 
781
-    POST /containers/e90e34656806/start HTTP/1.1
781
+    POST /v1.19/containers/e90e34656806/start HTTP/1.1
782 782
 
783 783
 **Example response**:
784 784
 
... ...
@@ -799,7 +799,7 @@ Stop the container `id`
799 799
 
800 800
 **Example request**:
801 801
 
802
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
802
+    POST /v1.19/containers/e90e34656806/stop?t=5 HTTP/1.1
803 803
 
804 804
 **Example response**:
805 805
 
... ...
@@ -824,7 +824,7 @@ Restart the container `id`
824 824
 
825 825
 **Example request**:
826 826
 
827
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
827
+    POST /v1.19/containers/e90e34656806/restart?t=5 HTTP/1.1
828 828
 
829 829
 **Example response**:
830 830
 
... ...
@@ -848,7 +848,7 @@ Kill the container `id`
848 848
 
849 849
 **Example request**:
850 850
 
851
-    POST /containers/e90e34656806/kill HTTP/1.1
851
+    POST /v1.19/containers/e90e34656806/kill HTTP/1.1
852 852
 
853 853
 **Example response**:
854 854
 
... ...
@@ -873,7 +873,7 @@ Rename the container `id` to a `new_name`
873 873
 
874 874
 **Example request**:
875 875
 
876
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
876
+    POST /v1.19/containers/e90e34656806/rename?name=new_name HTTP/1.1
877 877
 
878 878
 **Example response**:
879 879
 
... ...
@@ -898,7 +898,7 @@ Pause the container `id`
898 898
 
899 899
 **Example request**:
900 900
 
901
-    POST /containers/e90e34656806/pause HTTP/1.1
901
+    POST /v1.19/containers/e90e34656806/pause HTTP/1.1
902 902
 
903 903
 **Example response**:
904 904
 
... ...
@@ -918,7 +918,7 @@ Unpause the container `id`
918 918
 
919 919
 **Example request**:
920 920
 
921
-    POST /containers/e90e34656806/unpause HTTP/1.1
921
+    POST /v1.19/containers/e90e34656806/unpause HTTP/1.1
922 922
 
923 923
 **Example response**:
924 924
 
... ...
@@ -938,7 +938,7 @@ Attach to the container `id`
938 938
 
939 939
 **Example request**:
940 940
 
941
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
941
+    POST /v1.19/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
942 942
 
943 943
 **Example response**:
944 944
 
... ...
@@ -1025,7 +1025,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1025 1025
 
1026 1026
 **Example request**
1027 1027
 
1028
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1028
+    GET /v1.19/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1029 1029
 
1030 1030
 **Example response**
1031 1031
 
... ...
@@ -1060,7 +1060,7 @@ Block until container `id` stops, then returns the exit code
1060 1060
 
1061 1061
 **Example request**:
1062 1062
 
1063
-    POST /containers/16253994b7c4/wait HTTP/1.1
1063
+    POST /v1.19/containers/16253994b7c4/wait HTTP/1.1
1064 1064
 
1065 1065
 **Example response**:
1066 1066
 
... ...
@@ -1112,7 +1112,7 @@ Copy files or folders of container `id`
1112 1112
 
1113 1113
 **Example request**:
1114 1114
 
1115
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1115
+    POST /v1.19/containers/4fa6e0f0c678/copy HTTP/1.1
1116 1116
     Content-Type: application/json
1117 1117
 
1118 1118
     {
... ...
@@ -1142,7 +1142,7 @@ Copy files or folders of container `id`
1142 1142
 
1143 1143
 **Example request**:
1144 1144
 
1145
-    GET /images/json?all=0 HTTP/1.1
1145
+    GET /v1.19/images/json?all=0 HTTP/1.1
1146 1146
 
1147 1147
 **Example response**:
1148 1148
 
... ...
@@ -1180,7 +1180,7 @@ Copy files or folders of container `id`
1180 1180
 
1181 1181
 **Example request, with digest information**:
1182 1182
 
1183
-    GET /images/json?digests=1 HTTP/1.1
1183
+    GET /v1.19/images/json?digests=1 HTTP/1.1
1184 1184
 
1185 1185
 **Example response, with digest information**:
1186 1186
 
... ...
@@ -1235,7 +1235,7 @@ Build an image from a Dockerfile
1235 1235
 
1236 1236
 **Example request**:
1237 1237
 
1238
-    POST /build HTTP/1.1
1238
+    POST /v1.19/build HTTP/1.1
1239 1239
 
1240 1240
     {% raw %}
1241 1241
     {{ TAR STREAM }}
... ...
@@ -1308,7 +1308,7 @@ Create an image either by pulling it from the registry or by importing it
1308 1308
 
1309 1309
 **Example request**:
1310 1310
 
1311
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1311
+    POST /v1.19/images/create?fromImage=busybox&tag=latest HTTP/1.1
1312 1312
 
1313 1313
 **Example response**:
1314 1314
 
... ...
@@ -1352,7 +1352,7 @@ Return low-level information on the image `name`
1352 1352
 
1353 1353
 **Example request**:
1354 1354
 
1355
-    GET /images/ubuntu/json HTTP/1.1
1355
+    GET /v1.19/images/ubuntu/json HTTP/1.1
1356 1356
 
1357 1357
 **Example response**:
1358 1358
 
... ...
@@ -1403,7 +1403,7 @@ Return the history of the image `name`
1403 1403
 
1404 1404
 **Example request**:
1405 1405
 
1406
-    GET /images/ubuntu/history HTTP/1.1
1406
+    GET /v1.19/images/ubuntu/history HTTP/1.1
1407 1407
 
1408 1408
 **Example response**:
1409 1409
 
... ...
@@ -1457,7 +1457,7 @@ Push the image `name` on the registry
1457 1457
 
1458 1458
 **Example request**:
1459 1459
 
1460
-    POST /images/test/push HTTP/1.1
1460
+    POST /v1.19/images/test/push HTTP/1.1
1461 1461
 
1462 1462
 **Example response**:
1463 1463
 
... ...
@@ -1475,7 +1475,7 @@ then be used in the URL. This duplicates the command line's flow.
1475 1475
 
1476 1476
 **Example request**:
1477 1477
 
1478
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
1478
+    POST /v1.19/images/registry.acme.com:5000/test/push HTTP/1.1
1479 1479
 
1480 1480
 
1481 1481
 **Query parameters**:
... ...
@@ -1500,7 +1500,7 @@ Tag the image `name` into a repository
1500 1500
 
1501 1501
 **Example request**:
1502 1502
 
1503
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1503
+    POST /v1.19/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1504 1504
 
1505 1505
 **Example response**:
1506 1506
 
... ...
@@ -1568,7 +1568,7 @@ be deprecated and replaced by the `is_automated` property.
1568 1568
 
1569 1569
 **Example request**:
1570 1570
 
1571
-    GET /images/search?term=sshd HTTP/1.1
1571
+    GET /v1.19/images/search?term=sshd HTTP/1.1
1572 1572
 
1573 1573
 **Example response**:
1574 1574
 
... ...
@@ -1622,7 +1622,7 @@ Get the default username and email
1622 1622
 
1623 1623
 **Example request**:
1624 1624
 
1625
-    POST /auth HTTP/1.1
1625
+    POST /v1.19/auth HTTP/1.1
1626 1626
     Content-Type: application/json
1627 1627
 
1628 1628
     {
... ...
@@ -1650,7 +1650,7 @@ Display system-wide information
1650 1650
 
1651 1651
 **Example request**:
1652 1652
 
1653
-    GET /info HTTP/1.1
1653
+    GET /v1.19/info HTTP/1.1
1654 1654
 
1655 1655
 **Example response**:
1656 1656
 
... ...
@@ -1719,7 +1719,7 @@ Show the docker version information
1719 1719
 
1720 1720
 **Example request**:
1721 1721
 
1722
-    GET /version HTTP/1.1
1722
+    GET /v1.19/version HTTP/1.1
1723 1723
 
1724 1724
 **Example response**:
1725 1725
 
... ...
@@ -1749,7 +1749,7 @@ Ping the docker server
1749 1749
 
1750 1750
 **Example request**:
1751 1751
 
1752
-    GET /_ping HTTP/1.1
1752
+    GET /v1.19/_ping HTTP/1.1
1753 1753
 
1754 1754
 **Example response**:
1755 1755
 
... ...
@@ -1771,7 +1771,7 @@ Create a new image from a container's changes
1771 1771
 
1772 1772
 **Example request**:
1773 1773
 
1774
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1774
+    POST /v1.19/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1775 1775
     Content-Type: application/json
1776 1776
 
1777 1777
     {
... ...
@@ -1982,7 +1982,7 @@ Sets up an exec instance in a running container `id`
1982 1982
 
1983 1983
 **Example request**:
1984 1984
 
1985
-    POST /containers/e90e34656806/exec HTTP/1.1
1985
+    POST /v1.19/containers/e90e34656806/exec HTTP/1.1
1986 1986
     Content-Type: application/json
1987 1987
 
1988 1988
     {
... ...
@@ -2030,7 +2030,7 @@ interactive session with the `exec` command.
2030 2030
 
2031 2031
 **Example request**:
2032 2032
 
2033
-    POST /exec/e90e34656806/start HTTP/1.1
2033
+    POST /v1.19/exec/e90e34656806/start HTTP/1.1
2034 2034
     Content-Type: application/json
2035 2035
 
2036 2036
     {
... ...
@@ -2070,7 +2070,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2070 2070
 
2071 2071
 **Example request**:
2072 2072
 
2073
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2073
+    POST /v1.19/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2074 2074
     Content-Type: text/plain
2075 2075
 
2076 2076
 **Example response**:
... ...
@@ -2096,7 +2096,7 @@ Return low-level information about the `exec` command `id`.
2096 2096
 
2097 2097
 **Example request**:
2098 2098
 
2099
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2099
+    GET /v1.19/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2100 2100
 
2101 2101
 **Example response**:
2102 2102
 
... ...
@@ -36,7 +36,7 @@ List containers
36 36
 
37 37
 **Example request**:
38 38
 
39
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
39
+    GET /v1.20/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
40 40
 
41 41
 **Example response**:
42 42
 
... ...
@@ -129,7 +129,7 @@ Create a container
129 129
 
130 130
 **Example request**:
131 131
 
132
-    POST /containers/create HTTP/1.1
132
+    POST /v1.20/containers/create HTTP/1.1
133 133
     Content-Type: application/json
134 134
 
135 135
     {
... ...
@@ -330,7 +330,7 @@ Return low-level information on the container `id`
330 330
 
331 331
 **Example request**:
332 332
 
333
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
333
+      GET /v1.20/containers/4fa6e0f0c678/json HTTP/1.1
334 334
 
335 335
 **Example response**:
336 336
 
... ...
@@ -474,7 +474,7 @@ supported on Windows.
474 474
 
475 475
 **Example request**:
476 476
 
477
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
477
+    GET /v1.20/containers/4fa6e0f0c678/top HTTP/1.1
478 478
 
479 479
 **Example response**:
480 480
 
... ...
@@ -497,7 +497,7 @@ supported on Windows.
497 497
 
498 498
 **Example request**:
499 499
 
500
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
500
+    GET /v1.20/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
501 501
 
502 502
 **Example response**:
503 503
 
... ...
@@ -539,7 +539,7 @@ Get `stdout` and `stderr` logs from the container ``id``
539 539
 
540 540
 **Example request**:
541 541
 
542
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
542
+     GET /v1.20/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
543 543
 
544 544
 **Example response**:
545 545
 
... ...
@@ -578,7 +578,7 @@ Inspect changes on container `id`'s filesystem
578 578
 
579 579
 **Example request**:
580 580
 
581
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
581
+    GET /v1.20/containers/4fa6e0f0c678/changes HTTP/1.1
582 582
 
583 583
 **Example response**:
584 584
 
... ...
@@ -620,7 +620,7 @@ Export the contents of container `id`
620 620
 
621 621
 **Example request**:
622 622
 
623
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
623
+    GET /v1.20/containers/4fa6e0f0c678/export HTTP/1.1
624 624
 
625 625
 **Example response**:
626 626
 
... ...
@@ -645,7 +645,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
645 645
 
646 646
 **Example request**:
647 647
 
648
-    GET /containers/redis1/stats HTTP/1.1
648
+    GET /v1.20/containers/redis1/stats HTTP/1.1
649 649
 
650 650
 **Example response**:
651 651
 
... ...
@@ -754,7 +754,7 @@ Resize the TTY for container with  `id`. You must restart the container for the
754 754
 
755 755
 **Example request**:
756 756
 
757
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
757
+      POST /v1.20/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
758 758
 
759 759
 **Example response**:
760 760
 
... ...
@@ -785,7 +785,7 @@ Start the container `id`
785 785
 
786 786
 **Example request**:
787 787
 
788
-    POST /containers/e90e34656806/start HTTP/1.1
788
+    POST /v1.20/containers/e90e34656806/start HTTP/1.1
789 789
 
790 790
 **Example response**:
791 791
 
... ...
@@ -806,7 +806,7 @@ Stop the container `id`
806 806
 
807 807
 **Example request**:
808 808
 
809
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
809
+    POST /v1.20/containers/e90e34656806/stop?t=5 HTTP/1.1
810 810
 
811 811
 **Example response**:
812 812
 
... ...
@@ -831,7 +831,7 @@ Restart the container `id`
831 831
 
832 832
 **Example request**:
833 833
 
834
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
834
+    POST /v1.20/containers/e90e34656806/restart?t=5 HTTP/1.1
835 835
 
836 836
 **Example response**:
837 837
 
... ...
@@ -855,7 +855,7 @@ Kill the container `id`
855 855
 
856 856
 **Example request**:
857 857
 
858
-    POST /containers/e90e34656806/kill HTTP/1.1
858
+    POST /v1.20/containers/e90e34656806/kill HTTP/1.1
859 859
 
860 860
 **Example response**:
861 861
 
... ...
@@ -880,7 +880,7 @@ Rename the container `id` to a `new_name`
880 880
 
881 881
 **Example request**:
882 882
 
883
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
883
+    POST /v1.20/containers/e90e34656806/rename?name=new_name HTTP/1.1
884 884
 
885 885
 **Example response**:
886 886
 
... ...
@@ -905,7 +905,7 @@ Pause the container `id`
905 905
 
906 906
 **Example request**:
907 907
 
908
-    POST /containers/e90e34656806/pause HTTP/1.1
908
+    POST /v1.20/containers/e90e34656806/pause HTTP/1.1
909 909
 
910 910
 **Example response**:
911 911
 
... ...
@@ -925,7 +925,7 @@ Unpause the container `id`
925 925
 
926 926
 **Example request**:
927 927
 
928
-    POST /containers/e90e34656806/unpause HTTP/1.1
928
+    POST /v1.20/containers/e90e34656806/unpause HTTP/1.1
929 929
 
930 930
 **Example response**:
931 931
 
... ...
@@ -945,7 +945,7 @@ Attach to the container `id`
945 945
 
946 946
 **Example request**:
947 947
 
948
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
948
+    POST /v1.20/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
949 949
 
950 950
 **Example response**:
951 951
 
... ...
@@ -1032,7 +1032,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1032 1032
 
1033 1033
 **Example request**
1034 1034
 
1035
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1035
+    GET /v1.20/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1036 1036
 
1037 1037
 **Example response**
1038 1038
 
... ...
@@ -1067,7 +1067,7 @@ Block until container `id` stops, then returns the exit code
1067 1067
 
1068 1068
 **Example request**:
1069 1069
 
1070
-    POST /containers/16253994b7c4/wait HTTP/1.1
1070
+    POST /v1.20/containers/16253994b7c4/wait HTTP/1.1
1071 1071
 
1072 1072
 **Example response**:
1073 1073
 
... ...
@@ -1121,7 +1121,7 @@ Copy files or folders of container `id`
1121 1121
 
1122 1122
 **Example request**:
1123 1123
 
1124
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1124
+    POST /v1.20/containers/4fa6e0f0c678/copy HTTP/1.1
1125 1125
     Content-Type: application/json
1126 1126
 
1127 1127
     {
... ...
@@ -1173,7 +1173,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1173 1173
 
1174 1174
 **Example request**:
1175 1175
 
1176
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1176
+    GET /v1.20/containers/8cce319429b2/archive?path=/root HTTP/1.1
1177 1177
 
1178 1178
 **Example response**:
1179 1179
 
... ...
@@ -1271,7 +1271,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1271 1271
 
1272 1272
 **Example request**:
1273 1273
 
1274
-    GET /images/json?all=0 HTTP/1.1
1274
+    GET /v1.20/images/json?all=0 HTTP/1.1
1275 1275
 
1276 1276
 **Example response**:
1277 1277
 
... ...
@@ -1309,7 +1309,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1309 1309
 
1310 1310
 **Example request, with digest information**:
1311 1311
 
1312
-    GET /images/json?digests=1 HTTP/1.1
1312
+    GET /v1.20/images/json?digests=1 HTTP/1.1
1313 1313
 
1314 1314
 **Example response, with digest information**:
1315 1315
 
... ...
@@ -1364,7 +1364,7 @@ Build an image from a Dockerfile
1364 1364
 
1365 1365
 **Example request**:
1366 1366
 
1367
-    POST /build HTTP/1.1
1367
+    POST /v1.20/build HTTP/1.1
1368 1368
 
1369 1369
     {% raw %}
1370 1370
     {{ TAR STREAM }}
... ...
@@ -1462,7 +1462,7 @@ Create an image either by pulling it from the registry or by importing it
1462 1462
 
1463 1463
 **Example request**:
1464 1464
 
1465
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1465
+    POST /v1.20/images/create?fromImage=busybox&tag=latest HTTP/1.1
1466 1466
 
1467 1467
 **Example response**:
1468 1468
 
... ...
@@ -1506,7 +1506,7 @@ Return low-level information on the image `name`
1506 1506
 
1507 1507
 **Example request**:
1508 1508
 
1509
-    GET /images/ubuntu/json HTTP/1.1
1509
+    GET /v1.20/images/ubuntu/json HTTP/1.1
1510 1510
 
1511 1511
 **Example response**:
1512 1512
 
... ...
@@ -1557,7 +1557,7 @@ Return the history of the image `name`
1557 1557
 
1558 1558
 **Example request**:
1559 1559
 
1560
-    GET /images/ubuntu/history HTTP/1.1
1560
+    GET /v1.20/images/ubuntu/history HTTP/1.1
1561 1561
 
1562 1562
 **Example response**:
1563 1563
 
... ...
@@ -1611,7 +1611,7 @@ Push the image `name` on the registry
1611 1611
 
1612 1612
 **Example request**:
1613 1613
 
1614
-    POST /images/test/push HTTP/1.1
1614
+    POST /v1.20/images/test/push HTTP/1.1
1615 1615
 
1616 1616
 **Example response**:
1617 1617
 
... ...
@@ -1629,7 +1629,7 @@ then be used in the URL. This duplicates the command line's flow.
1629 1629
 
1630 1630
 **Example request**:
1631 1631
 
1632
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
1632
+    POST /v1.20/images/registry.acme.com:5000/test/push HTTP/1.1
1633 1633
 
1634 1634
 
1635 1635
 **Query parameters**:
... ...
@@ -1654,7 +1654,7 @@ Tag the image `name` into a repository
1654 1654
 
1655 1655
 **Example request**:
1656 1656
 
1657
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1657
+    POST /v1.20/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1658 1658
 
1659 1659
 **Example response**:
1660 1660
 
... ...
@@ -1719,7 +1719,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
1719 1719
 
1720 1720
 **Example request**:
1721 1721
 
1722
-    GET /images/search?term=sshd HTTP/1.1
1722
+    GET /v1.20/images/search?term=sshd HTTP/1.1
1723 1723
 
1724 1724
 **Example response**:
1725 1725
 
... ...
@@ -1770,7 +1770,7 @@ Get the default username and email
1770 1770
 
1771 1771
 **Example request**:
1772 1772
 
1773
-    POST /auth HTTP/1.1
1773
+    POST /v1.20/auth HTTP/1.1
1774 1774
     Content-Type: application/json
1775 1775
 
1776 1776
     {
... ...
@@ -1798,7 +1798,7 @@ Display system-wide information
1798 1798
 
1799 1799
 **Example request**:
1800 1800
 
1801
-    GET /info HTTP/1.1
1801
+    GET /v1.20/info HTTP/1.1
1802 1802
 
1803 1803
 **Example response**:
1804 1804
 
... ...
@@ -1867,7 +1867,7 @@ Show the docker version information
1867 1867
 
1868 1868
 **Example request**:
1869 1869
 
1870
-    GET /version HTTP/1.1
1870
+    GET /v1.20/version HTTP/1.1
1871 1871
 
1872 1872
 **Example response**:
1873 1873
 
... ...
@@ -1898,7 +1898,7 @@ Ping the docker server
1898 1898
 
1899 1899
 **Example request**:
1900 1900
 
1901
-    GET /_ping HTTP/1.1
1901
+    GET /v1.20/_ping HTTP/1.1
1902 1902
 
1903 1903
 **Example response**:
1904 1904
 
... ...
@@ -1920,7 +1920,7 @@ Create a new image from a container's changes
1920 1920
 
1921 1921
 **Example request**:
1922 1922
 
1923
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1923
+    POST /v1.20/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
1924 1924
     Content-Type: application/json
1925 1925
 
1926 1926
     {
... ...
@@ -2137,7 +2137,7 @@ Sets up an exec instance in a running container `id`
2137 2137
 
2138 2138
 **Example request**:
2139 2139
 
2140
-    POST /containers/e90e34656806/exec HTTP/1.1
2140
+    POST /v1.20/containers/e90e34656806/exec HTTP/1.1
2141 2141
     Content-Type: application/json
2142 2142
 
2143 2143
     {
... ...
@@ -2185,7 +2185,7 @@ interactive session with the `exec` command.
2185 2185
 
2186 2186
 **Example request**:
2187 2187
 
2188
-    POST /exec/e90e34656806/start HTTP/1.1
2188
+    POST /v1.20/exec/e90e34656806/start HTTP/1.1
2189 2189
     Content-Type: application/json
2190 2190
 
2191 2191
     {
... ...
@@ -2225,7 +2225,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2225 2225
 
2226 2226
 **Example request**:
2227 2227
 
2228
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2228
+    POST /v1.20/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2229 2229
     Content-Type: text/plain
2230 2230
 
2231 2231
 **Example response**:
... ...
@@ -2251,7 +2251,7 @@ Return low-level information about the `exec` command `id`.
2251 2251
 
2252 2252
 **Example request**:
2253 2253
 
2254
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2254
+    GET /v1.20/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2255 2255
 
2256 2256
 **Example response**:
2257 2257
 
... ...
@@ -38,7 +38,7 @@ List containers
38 38
 
39 39
 **Example request**:
40 40
 
41
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
41
+    GET /v1.21/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
42 42
 
43 43
 **Example response**:
44 44
 
... ...
@@ -135,7 +135,7 @@ Create a container
135 135
 
136 136
 **Example request**:
137 137
 
138
-    POST /containers/create HTTP/1.1
138
+    POST /v1.21/containers/create HTTP/1.1
139 139
     Content-Type: application/json
140 140
 
141 141
     {
... ...
@@ -353,7 +353,7 @@ Return low-level information on the container `id`
353 353
 
354 354
 **Example request**:
355 355
 
356
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
356
+      GET /v1.21/containers/4fa6e0f0c678/json HTTP/1.1
357 357
 
358 358
 **Example response**:
359 359
 
... ...
@@ -511,7 +511,7 @@ Return low-level information on the container `id`
511 511
 
512 512
 **Example request, with size information**:
513 513
 
514
-    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1
514
+    GET /v1.21/containers/4fa6e0f0c678/json?size=1 HTTP/1.1
515 515
 
516 516
 **Example response, with size information**:
517 517
 
... ...
@@ -545,7 +545,7 @@ supported on Windows.
545 545
 
546 546
 **Example request**:
547 547
 
548
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
548
+    GET /v1.21/containers/4fa6e0f0c678/top HTTP/1.1
549 549
 
550 550
 **Example response**:
551 551
 
... ...
@@ -568,7 +568,7 @@ supported on Windows.
568 568
 
569 569
 **Example request**:
570 570
 
571
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
571
+    GET /v1.21/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
572 572
 
573 573
 **Example response**:
574 574
 
... ...
@@ -610,7 +610,7 @@ Get `stdout` and `stderr` logs from the container ``id``
610 610
 
611 611
 **Example request**:
612 612
 
613
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
613
+     GET /v1.21/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
614 614
 
615 615
 **Example response**:
616 616
 
... ...
@@ -649,7 +649,7 @@ Inspect changes on container `id`'s filesystem
649 649
 
650 650
 **Example request**:
651 651
 
652
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
652
+    GET /v1.21/containers/4fa6e0f0c678/changes HTTP/1.1
653 653
 
654 654
 **Example response**:
655 655
 
... ...
@@ -691,7 +691,7 @@ Export the contents of container `id`
691 691
 
692 692
 **Example request**:
693 693
 
694
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
694
+    GET /v1.21/containers/4fa6e0f0c678/export HTTP/1.1
695 695
 
696 696
 **Example response**:
697 697
 
... ...
@@ -716,7 +716,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
716 716
 
717 717
 **Example request**:
718 718
 
719
-    GET /containers/redis1/stats HTTP/1.1
719
+    GET /v1.21/containers/redis1/stats HTTP/1.1
720 720
 
721 721
 **Example response**:
722 722
 
... ...
@@ -837,7 +837,7 @@ Resize the TTY for container with  `id`. The unit is number of characters. You m
837 837
 
838 838
 **Example request**:
839 839
 
840
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
840
+      POST /v1.21/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
841 841
 
842 842
 **Example response**:
843 843
 
... ...
@@ -868,7 +868,7 @@ Start the container `id`
868 868
 
869 869
 **Example request**:
870 870
 
871
-    POST /containers/e90e34656806/start HTTP/1.1
871
+    POST /v1.21/containers/e90e34656806/start HTTP/1.1
872 872
 
873 873
 **Example response**:
874 874
 
... ...
@@ -889,7 +889,7 @@ Stop the container `id`
889 889
 
890 890
 **Example request**:
891 891
 
892
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
892
+    POST /v1.21/containers/e90e34656806/stop?t=5 HTTP/1.1
893 893
 
894 894
 **Example response**:
895 895
 
... ...
@@ -914,7 +914,7 @@ Restart the container `id`
914 914
 
915 915
 **Example request**:
916 916
 
917
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
917
+    POST /v1.21/containers/e90e34656806/restart?t=5 HTTP/1.1
918 918
 
919 919
 **Example response**:
920 920
 
... ...
@@ -938,7 +938,7 @@ Kill the container `id`
938 938
 
939 939
 **Example request**:
940 940
 
941
-    POST /containers/e90e34656806/kill HTTP/1.1
941
+    POST /v1.21/containers/e90e34656806/kill HTTP/1.1
942 942
 
943 943
 **Example response**:
944 944
 
... ...
@@ -963,7 +963,7 @@ Rename the container `id` to a `new_name`
963 963
 
964 964
 **Example request**:
965 965
 
966
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
966
+    POST /v1.21/containers/e90e34656806/rename?name=new_name HTTP/1.1
967 967
 
968 968
 **Example response**:
969 969
 
... ...
@@ -988,7 +988,7 @@ Pause the container `id`
988 988
 
989 989
 **Example request**:
990 990
 
991
-    POST /containers/e90e34656806/pause HTTP/1.1
991
+    POST /v1.21/containers/e90e34656806/pause HTTP/1.1
992 992
 
993 993
 **Example response**:
994 994
 
... ...
@@ -1008,7 +1008,7 @@ Unpause the container `id`
1008 1008
 
1009 1009
 **Example request**:
1010 1010
 
1011
-    POST /containers/e90e34656806/unpause HTTP/1.1
1011
+    POST /v1.21/containers/e90e34656806/unpause HTTP/1.1
1012 1012
 
1013 1013
 **Example response**:
1014 1014
 
... ...
@@ -1028,7 +1028,7 @@ Attach to the container `id`
1028 1028
 
1029 1029
 **Example request**:
1030 1030
 
1031
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1031
+    POST /v1.21/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1032 1032
 
1033 1033
 **Example response**:
1034 1034
 
... ...
@@ -1115,7 +1115,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1115 1115
 
1116 1116
 **Example request**
1117 1117
 
1118
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1118
+    GET /v1.21/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1119 1119
 
1120 1120
 **Example response**
1121 1121
 
... ...
@@ -1150,7 +1150,7 @@ Block until container `id` stops, then returns the exit code
1150 1150
 
1151 1151
 **Example request**:
1152 1152
 
1153
-    POST /containers/16253994b7c4/wait HTTP/1.1
1153
+    POST /v1.21/containers/16253994b7c4/wait HTTP/1.1
1154 1154
 
1155 1155
 **Example response**:
1156 1156
 
... ...
@@ -1204,7 +1204,7 @@ Copy files or folders of container `id`
1204 1204
 
1205 1205
 **Example request**:
1206 1206
 
1207
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1207
+    POST /v1.21/containers/4fa6e0f0c678/copy HTTP/1.1
1208 1208
     Content-Type: application/json
1209 1209
 
1210 1210
     {
... ...
@@ -1256,7 +1256,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1256 1256
 
1257 1257
 **Example request**:
1258 1258
 
1259
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1259
+    GET /v1.21/containers/8cce319429b2/archive?path=/root HTTP/1.1
1260 1260
 
1261 1261
 **Example response**:
1262 1262
 
... ...
@@ -1354,7 +1354,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1354 1354
 
1355 1355
 **Example request**:
1356 1356
 
1357
-    GET /images/json?all=0 HTTP/1.1
1357
+    GET /v1.21/images/json?all=0 HTTP/1.1
1358 1358
 
1359 1359
 **Example response**:
1360 1360
 
... ...
@@ -1392,7 +1392,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1392 1392
 
1393 1393
 **Example request, with digest information**:
1394 1394
 
1395
-    GET /images/json?digests=1 HTTP/1.1
1395
+    GET /v1.21/images/json?digests=1 HTTP/1.1
1396 1396
 
1397 1397
 **Example response, with digest information**:
1398 1398
 
... ...
@@ -1447,7 +1447,7 @@ Build an image from a Dockerfile
1447 1447
 
1448 1448
 **Example request**:
1449 1449
 
1450
-    POST /build HTTP/1.1
1450
+    POST /v1.21/build HTTP/1.1
1451 1451
 
1452 1452
     {% raw %}
1453 1453
     {{ TAR STREAM }}
... ...
@@ -1551,7 +1551,7 @@ Create an image either by pulling it from the registry or by importing it
1551 1551
 
1552 1552
 **Example request**:
1553 1553
 
1554
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1554
+    POST /v1.21/images/create?fromImage=busybox&tag=latest HTTP/1.1
1555 1555
 
1556 1556
 **Example response**:
1557 1557
 
... ...
@@ -1599,7 +1599,7 @@ Return low-level information on the image `name`
1599 1599
 
1600 1600
 **Example request**:
1601 1601
 
1602
-    GET /images/example/json HTTP/1.1
1602
+    GET /v1.21/images/example/json HTTP/1.1
1603 1603
 
1604 1604
 **Example response**:
1605 1605
 
... ...
@@ -1710,7 +1710,7 @@ Return the history of the image `name`
1710 1710
 
1711 1711
 **Example request**:
1712 1712
 
1713
-    GET /images/ubuntu/history HTTP/1.1
1713
+    GET /v1.21/images/ubuntu/history HTTP/1.1
1714 1714
 
1715 1715
 **Example response**:
1716 1716
 
... ...
@@ -1764,7 +1764,7 @@ Push the image `name` on the registry
1764 1764
 
1765 1765
 **Example request**:
1766 1766
 
1767
-    POST /images/test/push HTTP/1.1
1767
+    POST /v1.21/images/test/push HTTP/1.1
1768 1768
 
1769 1769
 **Example response**:
1770 1770
 
... ...
@@ -1782,7 +1782,7 @@ then be used in the URL. This duplicates the command line's flow.
1782 1782
 
1783 1783
 **Example request**:
1784 1784
 
1785
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
1785
+    POST /v1.21/images/registry.acme.com:5000/test/push HTTP/1.1
1786 1786
 
1787 1787
 
1788 1788
 **Query parameters**:
... ...
@@ -1807,7 +1807,7 @@ Tag the image `name` into a repository
1807 1807
 
1808 1808
 **Example request**:
1809 1809
 
1810
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1810
+    POST /v1.21/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
1811 1811
 
1812 1812
 **Example response**:
1813 1813
 
... ...
@@ -1872,7 +1872,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
1872 1872
 
1873 1873
 **Example request**:
1874 1874
 
1875
-    GET /images/search?term=sshd HTTP/1.1
1875
+    GET /v1.21/images/search?term=sshd HTTP/1.1
1876 1876
 
1877 1877
 **Example response**:
1878 1878
 
... ...
@@ -1923,7 +1923,7 @@ Get the default username and email
1923 1923
 
1924 1924
 **Example request**:
1925 1925
 
1926
-    POST /auth HTTP/1.1
1926
+    POST /v1.21/auth HTTP/1.1
1927 1927
     Content-Type: application/json
1928 1928
 
1929 1929
     {
... ...
@@ -1951,7 +1951,7 @@ Display system-wide information
1951 1951
 
1952 1952
 **Example request**:
1953 1953
 
1954
-    GET /info HTTP/1.1
1954
+    GET /v1.21/info HTTP/1.1
1955 1955
 
1956 1956
 **Example response**:
1957 1957
 
... ...
@@ -2022,7 +2022,7 @@ Show the docker version information
2022 2022
 
2023 2023
 **Example request**:
2024 2024
 
2025
-    GET /version HTTP/1.1
2025
+    GET /v1.21/version HTTP/1.1
2026 2026
 
2027 2027
 **Example response**:
2028 2028
 
... ...
@@ -2053,7 +2053,7 @@ Ping the docker server
2053 2053
 
2054 2054
 **Example request**:
2055 2055
 
2056
-    GET /_ping HTTP/1.1
2056
+    GET /v1.21/_ping HTTP/1.1
2057 2057
 
2058 2058
 **Example response**:
2059 2059
 
... ...
@@ -2075,7 +2075,7 @@ Create a new image from a container's changes
2075 2075
 
2076 2076
 **Example request**:
2077 2077
 
2078
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2078
+    POST /v1.21/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2079 2079
     Content-Type: application/json
2080 2080
 
2081 2081
     {
... ...
@@ -2293,7 +2293,7 @@ Sets up an exec instance in a running container `id`
2293 2293
 
2294 2294
 **Example request**:
2295 2295
 
2296
-    POST /containers/e90e34656806/exec HTTP/1.1
2296
+    POST /v1.21/containers/e90e34656806/exec HTTP/1.1
2297 2297
     Content-Type: application/json
2298 2298
 
2299 2299
     {
... ...
@@ -2345,7 +2345,7 @@ interactive session with the `exec` command.
2345 2345
 
2346 2346
 **Example request**:
2347 2347
 
2348
-    POST /exec/e90e34656806/start HTTP/1.1
2348
+    POST /v1.21/exec/e90e34656806/start HTTP/1.1
2349 2349
     Content-Type: application/json
2350 2350
 
2351 2351
     {
... ...
@@ -2386,7 +2386,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2386 2386
 
2387 2387
 **Example request**:
2388 2388
 
2389
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2389
+    POST /v1.21/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2390 2390
     Content-Type: text/plain
2391 2391
 
2392 2392
 **Example response**:
... ...
@@ -2412,7 +2412,7 @@ Return low-level information about the `exec` command `id`.
2412 2412
 
2413 2413
 **Example request**:
2414 2414
 
2415
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2415
+    GET /v1.21/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2416 2416
 
2417 2417
 **Example response**:
2418 2418
 
... ...
@@ -2538,7 +2538,7 @@ Return low-level information about the `exec` command `id`.
2538 2538
 
2539 2539
 **Example request**:
2540 2540
 
2541
-    GET /volumes HTTP/1.1
2541
+    GET /v1.21/volumes HTTP/1.1
2542 2542
 
2543 2543
 **Example response**:
2544 2544
 
... ...
@@ -2572,7 +2572,7 @@ Create a volume
2572 2572
 
2573 2573
 **Example request**:
2574 2574
 
2575
-    POST /volumes/create HTTP/1.1
2575
+    POST /v1.21/volumes/create HTTP/1.1
2576 2576
     Content-Type: application/json
2577 2577
 
2578 2578
     {
... ...
@@ -2658,7 +2658,7 @@ Instruct the driver to remove the volume (`name`).
2658 2658
 
2659 2659
 **Example request**:
2660 2660
 
2661
-    GET /networks HTTP/1.1
2661
+    GET /v1.21/networks HTTP/1.1
2662 2662
 
2663 2663
 **Example response**:
2664 2664
 
... ...
@@ -2739,7 +2739,7 @@ Content-Type: application/json
2739 2739
 
2740 2740
 **Example request**:
2741 2741
 
2742
-    GET /networks/f2de39df4171b0dc801e8002d1d999b77256983dfc63041c0f34030aa3977566 HTTP/1.1
2742
+    GET /v1.21/networks/f2de39df4171b0dc801e8002d1d999b77256983dfc63041c0f34030aa3977566 HTTP/1.1
2743 2743
 
2744 2744
 **Example response**:
2745 2745
 
... ...
@@ -2793,7 +2793,7 @@ Create a network
2793 2793
 **Example request**:
2794 2794
 
2795 2795
 ```
2796
-POST /networks/create HTTP/1.1
2796
+POST /v1.21/networks/create HTTP/1.1
2797 2797
 Content-Type: application/json
2798 2798
 
2799 2799
 {
... ...
@@ -2851,7 +2851,7 @@ Connect a container to a network
2851 2851
 **Example request**:
2852 2852
 
2853 2853
 ```
2854
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
2854
+POST /v1.21/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
2855 2855
 Content-Type: application/json
2856 2856
 
2857 2857
 {
... ...
@@ -2882,7 +2882,7 @@ Disconnect a container from a network
2882 2882
 **Example request**:
2883 2883
 
2884 2884
 ```
2885
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
2885
+POST /v1.21/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
2886 2886
 Content-Type: application/json
2887 2887
 
2888 2888
 {
... ...
@@ -36,7 +36,7 @@ List containers
36 36
 
37 37
 **Example request**:
38 38
 
39
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
39
+    GET /v1.22/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
40 40
 
41 41
 **Example response**:
42 42
 
... ...
@@ -218,7 +218,7 @@ Create a container
218 218
 
219 219
 **Example request**:
220 220
 
221
-    POST /containers/create HTTP/1.1
221
+    POST /v1.22/containers/create HTTP/1.1
222 222
     Content-Type: application/json
223 223
 
224 224
     {
... ...
@@ -463,7 +463,7 @@ Return low-level information on the container `id`
463 463
 
464 464
 **Example request**:
465 465
 
466
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
466
+      GET /v1.22/containers/4fa6e0f0c678/json HTTP/1.1
467 467
 
468 468
 **Example response**:
469 469
 
... ...
@@ -634,7 +634,7 @@ Return low-level information on the container `id`
634 634
 
635 635
 **Example request, with size information**:
636 636
 
637
-    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1
637
+    GET /v1.22/containers/4fa6e0f0c678/json?size=1 HTTP/1.1
638 638
 
639 639
 **Example response, with size information**:
640 640
 
... ...
@@ -668,7 +668,7 @@ supported on Windows.
668 668
 
669 669
 **Example request**:
670 670
 
671
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
671
+    GET /v1.22/containers/4fa6e0f0c678/top HTTP/1.1
672 672
 
673 673
 **Example response**:
674 674
 
... ...
@@ -691,7 +691,7 @@ supported on Windows.
691 691
 
692 692
 **Example request**:
693 693
 
694
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
694
+    GET /v1.22/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
695 695
 
696 696
 **Example response**:
697 697
 
... ...
@@ -733,7 +733,7 @@ Get `stdout` and `stderr` logs from the container ``id``
733 733
 
734 734
 **Example request**:
735 735
 
736
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
736
+     GET /v1.22/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
737 737
 
738 738
 **Example response**:
739 739
 
... ...
@@ -772,7 +772,7 @@ Inspect changes on container `id`'s filesystem
772 772
 
773 773
 **Example request**:
774 774
 
775
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
775
+    GET /v1.22/containers/4fa6e0f0c678/changes HTTP/1.1
776 776
 
777 777
 **Example response**:
778 778
 
... ...
@@ -814,7 +814,7 @@ Export the contents of container `id`
814 814
 
815 815
 **Example request**:
816 816
 
817
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
817
+    GET /v1.22/containers/4fa6e0f0c678/export HTTP/1.1
818 818
 
819 819
 **Example response**:
820 820
 
... ...
@@ -839,7 +839,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
839 839
 
840 840
 **Example request**:
841 841
 
842
-    GET /containers/redis1/stats HTTP/1.1
842
+    GET /v1.22/containers/redis1/stats HTTP/1.1
843 843
 
844 844
 **Example response**:
845 845
 
... ...
@@ -960,7 +960,7 @@ Resize the TTY for container with  `id`. The unit is number of characters. You m
960 960
 
961 961
 **Example request**:
962 962
 
963
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
963
+      POST /v1.22/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
964 964
 
965 965
 **Example response**:
966 966
 
... ...
@@ -991,7 +991,7 @@ Start the container `id`
991 991
 
992 992
 **Example request**:
993 993
 
994
-    POST /containers/e90e34656806/start HTTP/1.1
994
+    POST /v1.22/containers/e90e34656806/start HTTP/1.1
995 995
 
996 996
 **Example response**:
997 997
 
... ...
@@ -1018,7 +1018,7 @@ Stop the container `id`
1018 1018
 
1019 1019
 **Example request**:
1020 1020
 
1021
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
1021
+    POST /v1.22/containers/e90e34656806/stop?t=5 HTTP/1.1
1022 1022
 
1023 1023
 **Example response**:
1024 1024
 
... ...
@@ -1043,7 +1043,7 @@ Restart the container `id`
1043 1043
 
1044 1044
 **Example request**:
1045 1045
 
1046
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
1046
+    POST /v1.22/containers/e90e34656806/restart?t=5 HTTP/1.1
1047 1047
 
1048 1048
 **Example response**:
1049 1049
 
... ...
@@ -1067,7 +1067,7 @@ Kill the container `id`
1067 1067
 
1068 1068
 **Example request**:
1069 1069
 
1070
-    POST /containers/e90e34656806/kill HTTP/1.1
1070
+    POST /v1.22/containers/e90e34656806/kill HTTP/1.1
1071 1071
 
1072 1072
 **Example response**:
1073 1073
 
... ...
@@ -1092,7 +1092,7 @@ Update resource configs of one or more containers.
1092 1092
 
1093 1093
 **Example request**:
1094 1094
 
1095
-       POST /containers/e90e34656806/update HTTP/1.1
1095
+       POST /v1.22/containers/e90e34656806/update HTTP/1.1
1096 1096
        Content-Type: application/json
1097 1097
 
1098 1098
        {
... ...
@@ -1132,7 +1132,7 @@ Rename the container `id` to a `new_name`
1132 1132
 
1133 1133
 **Example request**:
1134 1134
 
1135
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
1135
+    POST /v1.22/containers/e90e34656806/rename?name=new_name HTTP/1.1
1136 1136
 
1137 1137
 **Example response**:
1138 1138
 
... ...
@@ -1157,7 +1157,7 @@ Pause the container `id`
1157 1157
 
1158 1158
 **Example request**:
1159 1159
 
1160
-    POST /containers/e90e34656806/pause HTTP/1.1
1160
+    POST /v1.22/containers/e90e34656806/pause HTTP/1.1
1161 1161
 
1162 1162
 **Example response**:
1163 1163
 
... ...
@@ -1177,7 +1177,7 @@ Unpause the container `id`
1177 1177
 
1178 1178
 **Example request**:
1179 1179
 
1180
-    POST /containers/e90e34656806/unpause HTTP/1.1
1180
+    POST /v1.22/containers/e90e34656806/unpause HTTP/1.1
1181 1181
 
1182 1182
 **Example response**:
1183 1183
 
... ...
@@ -1197,7 +1197,7 @@ Attach to the container `id`
1197 1197
 
1198 1198
 **Example request**:
1199 1199
 
1200
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1200
+    POST /v1.22/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1201 1201
 
1202 1202
 **Example response**:
1203 1203
 
... ...
@@ -1288,7 +1288,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1288 1288
 
1289 1289
 **Example request**
1290 1290
 
1291
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1291
+    GET /v1.22/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1292 1292
 
1293 1293
 **Example response**
1294 1294
 
... ...
@@ -1326,7 +1326,7 @@ Block until container `id` stops, then returns the exit code
1326 1326
 
1327 1327
 **Example request**:
1328 1328
 
1329
-    POST /containers/16253994b7c4/wait HTTP/1.1
1329
+    POST /v1.22/containers/16253994b7c4/wait HTTP/1.1
1330 1330
 
1331 1331
 **Example response**:
1332 1332
 
... ...
@@ -1380,7 +1380,7 @@ Copy files or folders of container `id`
1380 1380
 
1381 1381
 **Example request**:
1382 1382
 
1383
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1383
+    POST /v1.22/containers/4fa6e0f0c678/copy HTTP/1.1
1384 1384
     Content-Type: application/json
1385 1385
 
1386 1386
     {
... ...
@@ -1432,7 +1432,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1432 1432
 
1433 1433
 **Example request**:
1434 1434
 
1435
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1435
+    GET /v1.22/containers/8cce319429b2/archive?path=/root HTTP/1.1
1436 1436
 
1437 1437
 **Example response**:
1438 1438
 
... ...
@@ -1530,7 +1530,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1530 1530
 
1531 1531
 **Example request**:
1532 1532
 
1533
-    GET /images/json?all=0 HTTP/1.1
1533
+    GET /v1.22/images/json?all=0 HTTP/1.1
1534 1534
 
1535 1535
 **Example response**:
1536 1536
 
... ...
@@ -1568,7 +1568,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1568 1568
 
1569 1569
 **Example request, with digest information**:
1570 1570
 
1571
-    GET /images/json?digests=1 HTTP/1.1
1571
+    GET /v1.22/images/json?digests=1 HTTP/1.1
1572 1572
 
1573 1573
 **Example response, with digest information**:
1574 1574
 
... ...
@@ -1623,7 +1623,7 @@ Build an image from a Dockerfile
1623 1623
 
1624 1624
 **Example request**:
1625 1625
 
1626
-    POST /build HTTP/1.1
1626
+    POST /v1.22/build HTTP/1.1
1627 1627
 
1628 1628
     {% raw %}
1629 1629
     {{ TAR STREAM }}
... ...
@@ -1728,7 +1728,7 @@ Create an image either by pulling it from the registry or by importing it
1728 1728
 
1729 1729
 **Example request**:
1730 1730
 
1731
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1731
+    POST /v1.22/images/create?fromImage=busybox&tag=latest HTTP/1.1
1732 1732
 
1733 1733
 **Example response**:
1734 1734
 
... ...
@@ -1794,7 +1794,7 @@ Return low-level information on the image `name`
1794 1794
 
1795 1795
 **Example request**:
1796 1796
 
1797
-    GET /images/example/json HTTP/1.1
1797
+    GET /v1.22/images/example/json HTTP/1.1
1798 1798
 
1799 1799
 **Example response**:
1800 1800
 
... ...
@@ -1905,7 +1905,7 @@ Return the history of the image `name`
1905 1905
 
1906 1906
 **Example request**:
1907 1907
 
1908
-    GET /images/ubuntu/history HTTP/1.1
1908
+    GET /v1.22/images/ubuntu/history HTTP/1.1
1909 1909
 
1910 1910
 **Example response**:
1911 1911
 
... ...
@@ -1959,7 +1959,7 @@ Push the image `name` on the registry
1959 1959
 
1960 1960
 **Example request**:
1961 1961
 
1962
-    POST /images/test/push HTTP/1.1
1962
+    POST /v1.22/images/test/push HTTP/1.1
1963 1963
 
1964 1964
 **Example response**:
1965 1965
 
... ...
@@ -1979,7 +1979,7 @@ The push is cancelled if the HTTP connection is closed.
1979 1979
 
1980 1980
 **Example request**:
1981 1981
 
1982
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
1982
+    POST /v1.22/images/registry.acme.com:5000/test/push HTTP/1.1
1983 1983
 
1984 1984
 
1985 1985
 **Query parameters**:
... ...
@@ -2021,7 +2021,7 @@ Tag the image `name` into a repository
2021 2021
 
2022 2022
 **Example request**:
2023 2023
 
2024
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
2024
+    POST /v1.22/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
2025 2025
 
2026 2026
 **Example response**:
2027 2027
 
... ...
@@ -2086,7 +2086,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
2086 2086
 
2087 2087
 **Example request**:
2088 2088
 
2089
-    GET /images/search?term=sshd HTTP/1.1
2089
+    GET /v1.22/images/search?term=sshd HTTP/1.1
2090 2090
 
2091 2091
 **Example response**:
2092 2092
 
... ...
@@ -2137,7 +2137,7 @@ Get the default username and email
2137 2137
 
2138 2138
 **Example request**:
2139 2139
 
2140
-    POST /auth HTTP/1.1
2140
+    POST /v1.22/auth HTTP/1.1
2141 2141
     Content-Type: application/json
2142 2142
 
2143 2143
     {
... ...
@@ -2165,7 +2165,7 @@ Display system-wide information
2165 2165
 
2166 2166
 **Example request**:
2167 2167
 
2168
-    GET /info HTTP/1.1
2168
+    GET /v1.22/info HTTP/1.1
2169 2169
 
2170 2170
 **Example response**:
2171 2171
 
... ...
@@ -2252,7 +2252,7 @@ Show the docker version information
2252 2252
 
2253 2253
 **Example request**:
2254 2254
 
2255
-    GET /version HTTP/1.1
2255
+    GET /v1.22/version HTTP/1.1
2256 2256
 
2257 2257
 **Example response**:
2258 2258
 
... ...
@@ -2284,7 +2284,7 @@ Ping the docker server
2284 2284
 
2285 2285
 **Example request**:
2286 2286
 
2287
-    GET /_ping HTTP/1.1
2287
+    GET /v1.22/_ping HTTP/1.1
2288 2288
 
2289 2289
 **Example response**:
2290 2290
 
... ...
@@ -2306,7 +2306,7 @@ Create a new image from a container's changes
2306 2306
 
2307 2307
 **Example request**:
2308 2308
 
2309
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2309
+    POST /v1.22/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2310 2310
     Content-Type: application/json
2311 2311
 
2312 2312
     {
... ...
@@ -2681,7 +2681,7 @@ Sets up an exec instance in a running container `id`
2681 2681
 
2682 2682
 **Example request**:
2683 2683
 
2684
-    POST /containers/e90e34656806/exec HTTP/1.1
2684
+    POST /v1.22/containers/e90e34656806/exec HTTP/1.1
2685 2685
     Content-Type: application/json
2686 2686
 
2687 2687
     {
... ...
@@ -2737,7 +2737,7 @@ interactive session with the `exec` command.
2737 2737
 
2738 2738
 **Example request**:
2739 2739
 
2740
-    POST /exec/e90e34656806/start HTTP/1.1
2740
+    POST /v1.22/exec/e90e34656806/start HTTP/1.1
2741 2741
     Content-Type: application/json
2742 2742
 
2743 2743
     {
... ...
@@ -2778,7 +2778,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2778 2778
 
2779 2779
 **Example request**:
2780 2780
 
2781
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2781
+    POST /v1.22/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2782 2782
     Content-Type: text/plain
2783 2783
 
2784 2784
 **Example response**:
... ...
@@ -2804,7 +2804,7 @@ Return low-level information about the `exec` command `id`.
2804 2804
 
2805 2805
 **Example request**:
2806 2806
 
2807
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2807
+    GET /v1.22/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2808 2808
 
2809 2809
 **Example response**:
2810 2810
 
... ...
@@ -2847,7 +2847,7 @@ Return low-level information about the `exec` command `id`.
2847 2847
 
2848 2848
 **Example request**:
2849 2849
 
2850
-    GET /volumes HTTP/1.1
2850
+    GET /v1.22/volumes HTTP/1.1
2851 2851
 
2852 2852
 **Example response**:
2853 2853
 
... ...
@@ -2882,7 +2882,7 @@ Create a volume
2882 2882
 
2883 2883
 **Example request**:
2884 2884
 
2885
-    POST /volumes/create HTTP/1.1
2885
+    POST /v1.22/volumes/create HTTP/1.1
2886 2886
     Content-Type: application/json
2887 2887
 
2888 2888
     {
... ...
@@ -2968,7 +2968,7 @@ Instruct the driver to remove the volume (`name`).
2968 2968
 
2969 2969
 **Example request**:
2970 2970
 
2971
-    GET /networks?filters={"type":{"custom":true}} HTTP/1.1
2971
+    GET /v1.22/networks?filters={"type":{"custom":true}} HTTP/1.1
2972 2972
 
2973 2973
 **Example response**:
2974 2974
 
... ...
@@ -3052,7 +3052,7 @@ Content-Type: application/json
3052 3052
 
3053 3053
 **Example request**:
3054 3054
 
3055
-    GET /networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3055
+    GET /v1.22/networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3056 3056
 
3057 3057
 **Example response**:
3058 3058
 
... ...
@@ -3111,7 +3111,7 @@ Create a network
3111 3111
 **Example request**:
3112 3112
 
3113 3113
 ```
3114
-POST /networks/create HTTP/1.1
3114
+POST /v1.22/networks/create HTTP/1.1
3115 3115
 Content-Type: application/json
3116 3116
 
3117 3117
 {
... ...
@@ -3178,7 +3178,7 @@ Connect a container to a network
3178 3178
 **Example request**:
3179 3179
 
3180 3180
 ```
3181
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3181
+POST /v1.22/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3182 3182
 Content-Type: application/json
3183 3183
 
3184 3184
 {
... ...
@@ -3215,7 +3215,7 @@ Disconnect a container from a network
3215 3215
 **Example request**:
3216 3216
 
3217 3217
 ```
3218
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3218
+POST /v1.22/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3219 3219
 Content-Type: application/json
3220 3220
 
3221 3221
 {
... ...
@@ -38,7 +38,7 @@ List containers
38 38
 
39 39
 **Example request**:
40 40
 
41
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
41
+    GET /v1.23/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
42 42
 
43 43
 **Example response**:
44 44
 
... ...
@@ -242,7 +242,7 @@ Create a container
242 242
 
243 243
 **Example request**:
244 244
 
245
-    POST /containers/create HTTP/1.1
245
+    POST /v1.23/containers/create HTTP/1.1
246 246
     Content-Type: application/json
247 247
 
248 248
     {
... ...
@@ -491,7 +491,7 @@ Return low-level information on the container `id`
491 491
 
492 492
 **Example request**:
493 493
 
494
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
494
+      GET /v1.23/containers/4fa6e0f0c678/json HTTP/1.1
495 495
 
496 496
 **Example response**:
497 497
 
... ...
@@ -662,7 +662,7 @@ Return low-level information on the container `id`
662 662
 
663 663
 **Example request, with size information**:
664 664
 
665
-    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1
665
+    GET /v1.23/containers/4fa6e0f0c678/json?size=1 HTTP/1.1
666 666
 
667 667
 **Example response, with size information**:
668 668
 
... ...
@@ -696,7 +696,7 @@ supported on Windows.
696 696
 
697 697
 **Example request**:
698 698
 
699
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
699
+    GET /v1.23/containers/4fa6e0f0c678/top HTTP/1.1
700 700
 
701 701
 **Example response**:
702 702
 
... ...
@@ -719,7 +719,7 @@ supported on Windows.
719 719
 
720 720
 **Example request**:
721 721
 
722
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
722
+    GET /v1.23/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
723 723
 
724 724
 **Example response**:
725 725
 
... ...
@@ -761,7 +761,7 @@ Get `stdout` and `stderr` logs from the container ``id``
761 761
 
762 762
 **Example request**:
763 763
 
764
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
764
+     GET /v1.23/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
765 765
 
766 766
 **Example response**:
767 767
 
... ...
@@ -800,7 +800,7 @@ Inspect changes on container `id`'s filesystem
800 800
 
801 801
 **Example request**:
802 802
 
803
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
803
+    GET /v1.23/containers/4fa6e0f0c678/changes HTTP/1.1
804 804
 
805 805
 **Example response**:
806 806
 
... ...
@@ -842,7 +842,7 @@ Export the contents of container `id`
842 842
 
843 843
 **Example request**:
844 844
 
845
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
845
+    GET /v1.23/containers/4fa6e0f0c678/export HTTP/1.1
846 846
 
847 847
 **Example response**:
848 848
 
... ...
@@ -867,7 +867,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
867 867
 
868 868
 **Example request**:
869 869
 
870
-    GET /containers/redis1/stats HTTP/1.1
870
+    GET /v1.23/containers/redis1/stats HTTP/1.1
871 871
 
872 872
 **Example response**:
873 873
 
... ...
@@ -991,7 +991,7 @@ Resize the TTY for container with  `id`. The unit is number of characters. You m
991 991
 
992 992
 **Example request**:
993 993
 
994
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
994
+      POST /v1.23/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
995 995
 
996 996
 **Example response**:
997 997
 
... ...
@@ -1022,7 +1022,7 @@ Start the container `id`
1022 1022
 
1023 1023
 **Example request**:
1024 1024
 
1025
-    POST /containers/e90e34656806/start HTTP/1.1
1025
+    POST /v1.23/containers/e90e34656806/start HTTP/1.1
1026 1026
 
1027 1027
 **Example response**:
1028 1028
 
... ...
@@ -1049,7 +1049,7 @@ Stop the container `id`
1049 1049
 
1050 1050
 **Example request**:
1051 1051
 
1052
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
1052
+    POST /v1.23/containers/e90e34656806/stop?t=5 HTTP/1.1
1053 1053
 
1054 1054
 **Example response**:
1055 1055
 
... ...
@@ -1074,7 +1074,7 @@ Restart the container `id`
1074 1074
 
1075 1075
 **Example request**:
1076 1076
 
1077
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
1077
+    POST /v1.23/containers/e90e34656806/restart?t=5 HTTP/1.1
1078 1078
 
1079 1079
 **Example response**:
1080 1080
 
... ...
@@ -1098,7 +1098,7 @@ Kill the container `id`
1098 1098
 
1099 1099
 **Example request**:
1100 1100
 
1101
-    POST /containers/e90e34656806/kill HTTP/1.1
1101
+    POST /v1.23/containers/e90e34656806/kill HTTP/1.1
1102 1102
 
1103 1103
 **Example response**:
1104 1104
 
... ...
@@ -1123,7 +1123,7 @@ Update configuration of one or more containers.
1123 1123
 
1124 1124
 **Example request**:
1125 1125
 
1126
-       POST /containers/e90e34656806/update HTTP/1.1
1126
+       POST /v1.23/containers/e90e34656806/update HTTP/1.1
1127 1127
        Content-Type: application/json
1128 1128
 
1129 1129
        {
... ...
@@ -1167,7 +1167,7 @@ Rename the container `id` to a `new_name`
1167 1167
 
1168 1168
 **Example request**:
1169 1169
 
1170
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
1170
+    POST /v1.23/containers/e90e34656806/rename?name=new_name HTTP/1.1
1171 1171
 
1172 1172
 **Example response**:
1173 1173
 
... ...
@@ -1192,7 +1192,7 @@ Pause the container `id`
1192 1192
 
1193 1193
 **Example request**:
1194 1194
 
1195
-    POST /containers/e90e34656806/pause HTTP/1.1
1195
+    POST /v1.23/containers/e90e34656806/pause HTTP/1.1
1196 1196
 
1197 1197
 **Example response**:
1198 1198
 
... ...
@@ -1212,7 +1212,7 @@ Unpause the container `id`
1212 1212
 
1213 1213
 **Example request**:
1214 1214
 
1215
-    POST /containers/e90e34656806/unpause HTTP/1.1
1215
+    POST /v1.23/containers/e90e34656806/unpause HTTP/1.1
1216 1216
 
1217 1217
 **Example response**:
1218 1218
 
... ...
@@ -1232,7 +1232,7 @@ Attach to the container `id`
1232 1232
 
1233 1233
 **Example request**:
1234 1234
 
1235
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1235
+    POST /v1.23/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1236 1236
 
1237 1237
 **Example response**:
1238 1238
 
... ...
@@ -1323,7 +1323,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1323 1323
 
1324 1324
 **Example request**
1325 1325
 
1326
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1326
+    GET /v1.23/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1327 1327
 
1328 1328
 **Example response**
1329 1329
 
... ...
@@ -1361,7 +1361,7 @@ Block until container `id` stops, then returns the exit code
1361 1361
 
1362 1362
 **Example request**:
1363 1363
 
1364
-    POST /containers/16253994b7c4/wait HTTP/1.1
1364
+    POST /v1.23/containers/16253994b7c4/wait HTTP/1.1
1365 1365
 
1366 1366
 **Example response**:
1367 1367
 
... ...
@@ -1415,7 +1415,7 @@ Copy files or folders of container `id`
1415 1415
 
1416 1416
 **Example request**:
1417 1417
 
1418
-    POST /containers/4fa6e0f0c678/copy HTTP/1.1
1418
+    POST /v1.23/containers/4fa6e0f0c678/copy HTTP/1.1
1419 1419
     Content-Type: application/json
1420 1420
 
1421 1421
     {
... ...
@@ -1467,7 +1467,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1467 1467
 
1468 1468
 **Example request**:
1469 1469
 
1470
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1470
+    GET /v1.23/containers/8cce319429b2/archive?path=/root HTTP/1.1
1471 1471
 
1472 1472
 **Example response**:
1473 1473
 
... ...
@@ -1565,7 +1565,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1565 1565
 
1566 1566
 **Example request**:
1567 1567
 
1568
-    GET /images/json?all=0 HTTP/1.1
1568
+    GET /v1.23/images/json?all=0 HTTP/1.1
1569 1569
 
1570 1570
 **Example response**:
1571 1571
 
... ...
@@ -1603,7 +1603,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1603 1603
 
1604 1604
 **Example request, with digest information**:
1605 1605
 
1606
-    GET /images/json?digests=1 HTTP/1.1
1606
+    GET /v1.23/images/json?digests=1 HTTP/1.1
1607 1607
 
1608 1608
 **Example response, with digest information**:
1609 1609
 
... ...
@@ -1658,7 +1658,7 @@ Build an image from a Dockerfile
1658 1658
 
1659 1659
 **Example request**:
1660 1660
 
1661
-    POST /build HTTP/1.1
1661
+    POST /v1.23/build HTTP/1.1
1662 1662
 
1663 1663
     {% raw %}
1664 1664
     {{ TAR STREAM }}
... ...
@@ -1764,7 +1764,7 @@ Create an image either by pulling it from the registry or by importing it
1764 1764
 
1765 1765
 **Example request**:
1766 1766
 
1767
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1767
+    POST /v1.23/images/create?fromImage=busybox&tag=latest HTTP/1.1
1768 1768
 
1769 1769
 **Example response**:
1770 1770
 
... ...
@@ -1830,7 +1830,7 @@ Return low-level information on the image `name`
1830 1830
 
1831 1831
 **Example request**:
1832 1832
 
1833
-    GET /images/example/json HTTP/1.1
1833
+    GET /v1.23/images/example/json HTTP/1.1
1834 1834
 
1835 1835
 **Example response**:
1836 1836
 
... ...
@@ -1948,7 +1948,7 @@ Return the history of the image `name`
1948 1948
 
1949 1949
 **Example request**:
1950 1950
 
1951
-    GET /images/ubuntu/history HTTP/1.1
1951
+    GET /v1.23/images/ubuntu/history HTTP/1.1
1952 1952
 
1953 1953
 **Example response**:
1954 1954
 
... ...
@@ -2002,7 +2002,7 @@ Push the image `name` on the registry
2002 2002
 
2003 2003
 **Example request**:
2004 2004
 
2005
-    POST /images/test/push HTTP/1.1
2005
+    POST /v1.23/images/test/push HTTP/1.1
2006 2006
 
2007 2007
 **Example response**:
2008 2008
 
... ...
@@ -2022,7 +2022,7 @@ The push is cancelled if the HTTP connection is closed.
2022 2022
 
2023 2023
 **Example request**:
2024 2024
 
2025
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
2025
+    POST /v1.23/images/registry.acme.com:5000/test/push HTTP/1.1
2026 2026
 
2027 2027
 
2028 2028
 **Query parameters**:
... ...
@@ -2064,7 +2064,7 @@ Tag the image `name` into a repository
2064 2064
 
2065 2065
 **Example request**:
2066 2066
 
2067
-    POST /images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
2067
+    POST /v1.23/images/test/tag?repo=myrepo&force=0&tag=v42 HTTP/1.1
2068 2068
 
2069 2069
 **Example response**:
2070 2070
 
... ...
@@ -2129,7 +2129,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
2129 2129
 
2130 2130
 **Example request**:
2131 2131
 
2132
-    GET /images/search?term=sshd HTTP/1.1
2132
+    GET /v1.23/images/search?term=sshd HTTP/1.1
2133 2133
 
2134 2134
 **Example response**:
2135 2135
 
... ...
@@ -2181,7 +2181,7 @@ if available, for accessing the registry without password.
2181 2181
 
2182 2182
 **Example request**:
2183 2183
 
2184
-    POST /auth HTTP/1.1
2184
+    POST /v1.23/auth HTTP/1.1
2185 2185
     Content-Type: application/json
2186 2186
 
2187 2187
     {
... ...
@@ -2213,7 +2213,7 @@ Display system-wide information
2213 2213
 
2214 2214
 **Example request**:
2215 2215
 
2216
-    GET /info HTTP/1.1
2216
+    GET /v1.23/info HTTP/1.1
2217 2217
 
2218 2218
 **Example response**:
2219 2219
 
... ...
@@ -2302,7 +2302,7 @@ Show the docker version information
2302 2302
 
2303 2303
 **Example request**:
2304 2304
 
2305
-    GET /version HTTP/1.1
2305
+    GET /v1.23/version HTTP/1.1
2306 2306
 
2307 2307
 **Example response**:
2308 2308
 
... ...
@@ -2334,7 +2334,7 @@ Ping the docker server
2334 2334
 
2335 2335
 **Example request**:
2336 2336
 
2337
-    GET /_ping HTTP/1.1
2337
+    GET /v1.23/_ping HTTP/1.1
2338 2338
 
2339 2339
 **Example response**:
2340 2340
 
... ...
@@ -2356,7 +2356,7 @@ Create a new image from a container's changes
2356 2356
 
2357 2357
 **Example request**:
2358 2358
 
2359
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2359
+    POST /v1.23/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2360 2360
     Content-Type: application/json
2361 2361
 
2362 2362
     {
... ...
@@ -2757,7 +2757,7 @@ Sets up an exec instance in a running container `id`
2757 2757
 
2758 2758
 **Example request**:
2759 2759
 
2760
-    POST /containers/e90e34656806/exec HTTP/1.1
2760
+    POST /v1.23/containers/e90e34656806/exec HTTP/1.1
2761 2761
     Content-Type: application/json
2762 2762
 
2763 2763
     {
... ...
@@ -2813,7 +2813,7 @@ interactive session with the `exec` command.
2813 2813
 
2814 2814
 **Example request**:
2815 2815
 
2816
-    POST /exec/e90e34656806/start HTTP/1.1
2816
+    POST /v1.23/exec/e90e34656806/start HTTP/1.1
2817 2817
     Content-Type: application/json
2818 2818
 
2819 2819
     {
... ...
@@ -2854,7 +2854,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2854 2854
 
2855 2855
 **Example request**:
2856 2856
 
2857
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2857
+    POST /v1.23/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2858 2858
     Content-Type: text/plain
2859 2859
 
2860 2860
 **Example response**:
... ...
@@ -2880,7 +2880,7 @@ Return low-level information about the `exec` command `id`.
2880 2880
 
2881 2881
 **Example request**:
2882 2882
 
2883
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2883
+    GET /v1.23/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2884 2884
 
2885 2885
 **Example response**:
2886 2886
 
... ...
@@ -2923,7 +2923,7 @@ Return low-level information about the `exec` command `id`.
2923 2923
 
2924 2924
 **Example request**:
2925 2925
 
2926
-    GET /volumes HTTP/1.1
2926
+    GET /v1.23/volumes HTTP/1.1
2927 2927
 
2928 2928
 **Example response**:
2929 2929
 
... ...
@@ -2958,7 +2958,7 @@ Create a volume
2958 2958
 
2959 2959
 **Example request**:
2960 2960
 
2961
-    POST /volumes/create HTTP/1.1
2961
+    POST /v1.23/volumes/create HTTP/1.1
2962 2962
     Content-Type: application/json
2963 2963
 
2964 2964
     {
... ...
@@ -3057,7 +3057,7 @@ Instruct the driver to remove the volume (`name`).
3057 3057
 
3058 3058
 **Example request**:
3059 3059
 
3060
-    GET /networks?filters={"type":{"custom":true}} HTTP/1.1
3060
+    GET /v1.23/networks?filters={"type":{"custom":true}} HTTP/1.1
3061 3061
 
3062 3062
 **Example response**:
3063 3063
 
... ...
@@ -3147,7 +3147,7 @@ Content-Type: application/json
3147 3147
 
3148 3148
 **Example request**:
3149 3149
 
3150
-    GET /networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3150
+    GET /v1.23/networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3151 3151
 
3152 3152
 **Example response**:
3153 3153
 
... ...
@@ -3212,7 +3212,7 @@ Create a network
3212 3212
 **Example request**:
3213 3213
 
3214 3214
 ```
3215
-POST /networks/create HTTP/1.1
3215
+POST /v1.23/networks/create HTTP/1.1
3216 3216
 Content-Type: application/json
3217 3217
 
3218 3218
 {
... ...
@@ -3295,7 +3295,7 @@ Connect a container to a network
3295 3295
 **Example request**:
3296 3296
 
3297 3297
 ```
3298
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3298
+POST /v1.23/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3299 3299
 Content-Type: application/json
3300 3300
 
3301 3301
 {
... ...
@@ -3332,7 +3332,7 @@ Disconnect a container from a network
3332 3332
 **Example request**:
3333 3333
 
3334 3334
 ```
3335
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3335
+POST /v1.23/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3336 3336
 Content-Type: application/json
3337 3337
 
3338 3338
 {
... ...
@@ -46,7 +46,7 @@ List containers
46 46
 
47 47
 **Example request**:
48 48
 
49
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
49
+    GET /v1.24/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
50 50
 
51 51
 **Example response**:
52 52
 
... ...
@@ -251,7 +251,7 @@ Create a container
251 251
 
252 252
 **Example request**:
253 253
 
254
-    POST /containers/create HTTP/1.1
254
+    POST /v1.24/containers/create HTTP/1.1
255 255
     Content-Type: application/json
256 256
 
257 257
     {
... ...
@@ -514,7 +514,7 @@ Return low-level information on the container `id`
514 514
 
515 515
 **Example request**:
516 516
 
517
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
517
+      GET /v1.24/containers/4fa6e0f0c678/json HTTP/1.1
518 518
 
519 519
 **Example response**:
520 520
 
... ...
@@ -692,7 +692,7 @@ Return low-level information on the container `id`
692 692
 
693 693
 **Example request, with size information**:
694 694
 
695
-    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1
695
+    GET /v1.24/containers/4fa6e0f0c678/json?size=1 HTTP/1.1
696 696
 
697 697
 **Example response, with size information**:
698 698
 
... ...
@@ -726,7 +726,7 @@ supported on Windows.
726 726
 
727 727
 **Example request**:
728 728
 
729
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
729
+    GET /v1.24/containers/4fa6e0f0c678/top HTTP/1.1
730 730
 
731 731
 **Example response**:
732 732
 
... ...
@@ -749,7 +749,7 @@ supported on Windows.
749 749
 
750 750
 **Example request**:
751 751
 
752
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
752
+    GET /v1.24/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
753 753
 
754 754
 **Example response**:
755 755
 
... ...
@@ -791,7 +791,7 @@ Get `stdout` and `stderr` logs from the container ``id``
791 791
 
792 792
 **Example request**:
793 793
 
794
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
794
+     GET /v1.24/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
795 795
 
796 796
 **Example response**:
797 797
 
... ...
@@ -831,7 +831,7 @@ Inspect changes on container `id`'s filesystem
831 831
 
832 832
 **Example request**:
833 833
 
834
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
834
+    GET /v1.24/containers/4fa6e0f0c678/changes HTTP/1.1
835 835
 
836 836
 **Example response**:
837 837
 
... ...
@@ -873,7 +873,7 @@ Export the contents of container `id`
873 873
 
874 874
 **Example request**:
875 875
 
876
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
876
+    GET /v1.24/containers/4fa6e0f0c678/export HTTP/1.1
877 877
 
878 878
 **Example response**:
879 879
 
... ...
@@ -898,7 +898,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
898 898
 
899 899
 **Example request**:
900 900
 
901
-    GET /containers/redis1/stats HTTP/1.1
901
+    GET /v1.24/containers/redis1/stats HTTP/1.1
902 902
 
903 903
 **Example response**:
904 904
 
... ...
@@ -1022,7 +1022,7 @@ Resize the TTY for container with  `id`. The unit is number of characters. You m
1022 1022
 
1023 1023
 **Example request**:
1024 1024
 
1025
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
1025
+      POST /v1.24/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
1026 1026
 
1027 1027
 **Example response**:
1028 1028
 
... ...
@@ -1049,7 +1049,7 @@ Start the container `id`
1049 1049
 
1050 1050
 **Example request**:
1051 1051
 
1052
-    POST /containers/e90e34656806/start HTTP/1.1
1052
+    POST /v1.24/containers/e90e34656806/start HTTP/1.1
1053 1053
 
1054 1054
 **Example response**:
1055 1055
 
... ...
@@ -1076,7 +1076,7 @@ Stop the container `id`
1076 1076
 
1077 1077
 **Example request**:
1078 1078
 
1079
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
1079
+    POST /v1.24/containers/e90e34656806/stop?t=5 HTTP/1.1
1080 1080
 
1081 1081
 **Example response**:
1082 1082
 
... ...
@@ -1101,7 +1101,7 @@ Restart the container `id`
1101 1101
 
1102 1102
 **Example request**:
1103 1103
 
1104
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
1104
+    POST /v1.24/containers/e90e34656806/restart?t=5 HTTP/1.1
1105 1105
 
1106 1106
 **Example response**:
1107 1107
 
... ...
@@ -1125,7 +1125,7 @@ Kill the container `id`
1125 1125
 
1126 1126
 **Example request**:
1127 1127
 
1128
-    POST /containers/e90e34656806/kill HTTP/1.1
1128
+    POST /v1.24/containers/e90e34656806/kill HTTP/1.1
1129 1129
 
1130 1130
 **Example response**:
1131 1131
 
... ...
@@ -1150,7 +1150,7 @@ Update configuration of one or more containers.
1150 1150
 
1151 1151
 **Example request**:
1152 1152
 
1153
-       POST /containers/e90e34656806/update HTTP/1.1
1153
+       POST /v1.24/containers/e90e34656806/update HTTP/1.1
1154 1154
        Content-Type: application/json
1155 1155
 
1156 1156
        {
... ...
@@ -1194,7 +1194,7 @@ Rename the container `id` to a `new_name`
1194 1194
 
1195 1195
 **Example request**:
1196 1196
 
1197
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
1197
+    POST /v1.24/containers/e90e34656806/rename?name=new_name HTTP/1.1
1198 1198
 
1199 1199
 **Example response**:
1200 1200
 
... ...
@@ -1219,7 +1219,7 @@ Pause the container `id`
1219 1219
 
1220 1220
 **Example request**:
1221 1221
 
1222
-    POST /containers/e90e34656806/pause HTTP/1.1
1222
+    POST /v1.24/containers/e90e34656806/pause HTTP/1.1
1223 1223
 
1224 1224
 **Example response**:
1225 1225
 
... ...
@@ -1239,7 +1239,7 @@ Unpause the container `id`
1239 1239
 
1240 1240
 **Example request**:
1241 1241
 
1242
-    POST /containers/e90e34656806/unpause HTTP/1.1
1242
+    POST /v1.24/containers/e90e34656806/unpause HTTP/1.1
1243 1243
 
1244 1244
 **Example response**:
1245 1245
 
... ...
@@ -1259,7 +1259,7 @@ Attach to the container `id`
1259 1259
 
1260 1260
 **Example request**:
1261 1261
 
1262
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1262
+    POST /v1.24/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1263 1263
 
1264 1264
 **Example response**:
1265 1265
 
... ...
@@ -1350,7 +1350,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1350 1350
 
1351 1351
 **Example request**
1352 1352
 
1353
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1353
+    GET /v1.24/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1354 1354
 
1355 1355
 **Example response**
1356 1356
 
... ...
@@ -1388,7 +1388,7 @@ Block until container `id` stops, then returns the exit code
1388 1388
 
1389 1389
 **Example request**:
1390 1390
 
1391
-    POST /containers/16253994b7c4/wait HTTP/1.1
1391
+    POST /v1.24/containers/16253994b7c4/wait HTTP/1.1
1392 1392
 
1393 1393
 **Example response**:
1394 1394
 
... ...
@@ -1462,7 +1462,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1462 1462
 
1463 1463
 **Example request**:
1464 1464
 
1465
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1465
+    GET /v1.24/containers/8cce319429b2/archive?path=/root HTTP/1.1
1466 1466
 
1467 1467
 **Example response**:
1468 1468
 
... ...
@@ -1560,7 +1560,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1560 1560
 
1561 1561
 **Example request**:
1562 1562
 
1563
-    GET /images/json?all=0 HTTP/1.1
1563
+    GET /v1.24/images/json?all=0 HTTP/1.1
1564 1564
 
1565 1565
 **Example response**:
1566 1566
 
... ...
@@ -1598,7 +1598,7 @@ Upload a tar archive to be extracted to a path in the filesystem of container
1598 1598
 
1599 1599
 **Example request, with digest information**:
1600 1600
 
1601
-    GET /images/json?digests=1 HTTP/1.1
1601
+    GET /v1.24/images/json?digests=1 HTTP/1.1
1602 1602
 
1603 1603
 **Example response, with digest information**:
1604 1604
 
... ...
@@ -1655,7 +1655,7 @@ Build an image from a Dockerfile
1655 1655
 
1656 1656
 **Example request**:
1657 1657
 
1658
-    POST /build HTTP/1.1
1658
+    POST /v1.24/build HTTP/1.1
1659 1659
 
1660 1660
     {% raw %}
1661 1661
     {{ TAR STREAM }}
... ...
@@ -1761,7 +1761,7 @@ Create an image either by pulling it from the registry or by importing it
1761 1761
 
1762 1762
 **Example request**:
1763 1763
 
1764
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1764
+    POST /v1.24/images/create?fromImage=busybox&tag=latest HTTP/1.1
1765 1765
 
1766 1766
 **Example response**:
1767 1767
 
... ...
@@ -1827,7 +1827,7 @@ Return low-level information on the image `name`
1827 1827
 
1828 1828
 **Example request**:
1829 1829
 
1830
-    GET /images/example/json HTTP/1.1
1830
+    GET /v1.24/images/example/json HTTP/1.1
1831 1831
 
1832 1832
 **Example response**:
1833 1833
 
... ...
@@ -1945,7 +1945,7 @@ Return the history of the image `name`
1945 1945
 
1946 1946
 **Example request**:
1947 1947
 
1948
-    GET /images/ubuntu/history HTTP/1.1
1948
+    GET /v1.24/images/ubuntu/history HTTP/1.1
1949 1949
 
1950 1950
 **Example response**:
1951 1951
 
... ...
@@ -1999,7 +1999,7 @@ Push the image `name` on the registry
1999 1999
 
2000 2000
 **Example request**:
2001 2001
 
2002
-    POST /images/test/push HTTP/1.1
2002
+    POST /v1.24/images/test/push HTTP/1.1
2003 2003
 
2004 2004
 **Example response**:
2005 2005
 
... ...
@@ -2019,7 +2019,7 @@ The push is cancelled if the HTTP connection is closed.
2019 2019
 
2020 2020
 **Example request**:
2021 2021
 
2022
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
2022
+    POST /v1.24/images/registry.acme.com:5000/test/push HTTP/1.1
2023 2023
 
2024 2024
 
2025 2025
 **Query parameters**:
... ...
@@ -2061,7 +2061,7 @@ Tag the image `name` into a repository
2061 2061
 
2062 2062
 **Example request**:
2063 2063
 
2064
-    POST /images/test/tag?repo=myrepo&tag=v42 HTTP/1.1
2064
+    POST /v1.24/images/test/tag?repo=myrepo&tag=v42 HTTP/1.1
2065 2065
 
2066 2066
 **Example response**:
2067 2067
 
... ...
@@ -2125,7 +2125,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
2125 2125
 
2126 2126
 **Example request**:
2127 2127
 
2128
-    GET /images/search?term=sshd HTTP/1.1
2128
+    GET /v1.24/images/search?term=sshd HTTP/1.1
2129 2129
 
2130 2130
 **Example response**:
2131 2131
 
... ...
@@ -2182,7 +2182,7 @@ if available, for accessing the registry without password.
2182 2182
 
2183 2183
 **Example request**:
2184 2184
 
2185
-    POST /auth HTTP/1.1
2185
+    POST /v1.24/auth HTTP/1.1
2186 2186
     Content-Type: application/json
2187 2187
 
2188 2188
     {
... ...
@@ -2214,7 +2214,7 @@ Display system-wide information
2214 2214
 
2215 2215
 **Example request**:
2216 2216
 
2217
-    GET /info HTTP/1.1
2217
+    GET /v1.24/info HTTP/1.1
2218 2218
 
2219 2219
 **Example response**:
2220 2220
 
... ...
@@ -2307,7 +2307,7 @@ Show the docker version information
2307 2307
 
2308 2308
 **Example request**:
2309 2309
 
2310
-    GET /version HTTP/1.1
2310
+    GET /v1.24/version HTTP/1.1
2311 2311
 
2312 2312
 **Example response**:
2313 2313
 
... ...
@@ -2339,7 +2339,7 @@ Ping the docker server
2339 2339
 
2340 2340
 **Example request**:
2341 2341
 
2342
-    GET /_ping HTTP/1.1
2342
+    GET /v1.24/_ping HTTP/1.1
2343 2343
 
2344 2344
 **Example response**:
2345 2345
 
... ...
@@ -2361,7 +2361,7 @@ Create a new image from a container's changes
2361 2361
 
2362 2362
 **Example request**:
2363 2363
 
2364
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2364
+    POST /v1.24/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2365 2365
     Content-Type: application/json
2366 2366
 
2367 2367
     {
... ...
@@ -2767,7 +2767,7 @@ Sets up an exec instance in a running container `id`
2767 2767
 
2768 2768
 **Example request**:
2769 2769
 
2770
-    POST /containers/e90e34656806/exec HTTP/1.1
2770
+    POST /v1.24/containers/e90e34656806/exec HTTP/1.1
2771 2771
     Content-Type: application/json
2772 2772
 
2773 2773
     {
... ...
@@ -2823,7 +2823,7 @@ interactive session with the `exec` command.
2823 2823
 
2824 2824
 **Example request**:
2825 2825
 
2826
-    POST /exec/e90e34656806/start HTTP/1.1
2826
+    POST /v1.24/exec/e90e34656806/start HTTP/1.1
2827 2827
     Content-Type: application/json
2828 2828
 
2829 2829
     {
... ...
@@ -2864,7 +2864,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
2864 2864
 
2865 2865
 **Example request**:
2866 2866
 
2867
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2867
+    POST /v1.24/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
2868 2868
     Content-Type: text/plain
2869 2869
 
2870 2870
 **Example response**:
... ...
@@ -2890,7 +2890,7 @@ Return low-level information about the `exec` command `id`.
2890 2890
 
2891 2891
 **Example request**:
2892 2892
 
2893
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2893
+    GET /v1.24/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
2894 2894
 
2895 2895
 **Example response**:
2896 2896
 
... ...
@@ -2933,7 +2933,7 @@ Return low-level information about the `exec` command `id`.
2933 2933
 
2934 2934
 **Example request**:
2935 2935
 
2936
-    GET /volumes HTTP/1.1
2936
+    GET /v1.24/volumes HTTP/1.1
2937 2937
 
2938 2938
 **Example response**:
2939 2939
 
... ...
@@ -2973,7 +2973,7 @@ Create a volume
2973 2973
 
2974 2974
 **Example request**:
2975 2975
 
2976
-    POST /volumes/create HTTP/1.1
2976
+    POST /v1.24/volumes/create HTTP/1.1
2977 2977
     Content-Type: application/json
2978 2978
 
2979 2979
     {
... ...
@@ -3103,7 +3103,7 @@ Instruct the driver to remove the volume (`name`).
3103 3103
 
3104 3104
 **Example request**:
3105 3105
 
3106
-    GET /networks?filters={"type":{"custom":true}} HTTP/1.1
3106
+    GET /v1.24/networks?filters={"type":{"custom":true}} HTTP/1.1
3107 3107
 
3108 3108
 **Example response**:
3109 3109
 
... ...
@@ -3195,7 +3195,7 @@ Content-Type: application/json
3195 3195
 
3196 3196
 **Example request**:
3197 3197
 
3198
-    GET /networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3198
+    GET /v1.24/networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3199 3199
 
3200 3200
 **Example response**:
3201 3201
 
... ...
@@ -3260,7 +3260,7 @@ Create a network
3260 3260
 **Example request**:
3261 3261
 
3262 3262
 ```
3263
-POST /networks/create HTTP/1.1
3263
+POST /v1.24/networks/create HTTP/1.1
3264 3264
 Content-Type: application/json
3265 3265
 
3266 3266
 {
... ...
@@ -3343,7 +3343,7 @@ Connect a container to a network
3343 3343
 **Example request**:
3344 3344
 
3345 3345
 ```
3346
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3346
+POST /v1.24/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3347 3347
 Content-Type: application/json
3348 3348
 
3349 3349
 {
... ...
@@ -3381,7 +3381,7 @@ Disconnect a container from a network
3381 3381
 **Example request**:
3382 3382
 
3383 3383
 ```
3384
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3384
+POST /v1.24/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3385 3385
 Content-Type: application/json
3386 3386
 
3387 3387
 {
... ...
@@ -3436,7 +3436,7 @@ Returns information about installed plugins.
3436 3436
 
3437 3437
 **Example request**:
3438 3438
 
3439
-    GET /plugins HTTP/1.1
3439
+    GET /v1.24/plugins HTTP/1.1
3440 3440
 
3441 3441
 **Example response**:
3442 3442
 
... ...
@@ -3568,7 +3568,7 @@ using the [`POST /plugins/(plugin name)/enable` endpoint](#enable-a-plugin).
3568 3568
 **Example request**:
3569 3569
 
3570 3570
 ```
3571
-POST /plugins/pull?name=tiborvass/no-remove:latest HTTP/1.1
3571
+POST /v1.24/plugins/pull?name=tiborvass/no-remove:latest HTTP/1.1
3572 3572
 ```
3573 3573
 
3574 3574
 The `:latest` tag is optional, and is used as default if omitted. When using
... ...
@@ -3629,7 +3629,7 @@ Returns detailed information about an installed plugin.
3629 3629
 **Example request**:
3630 3630
 
3631 3631
 ```
3632
-GET /plugins/tiborvass/no-remove:latest HTTP/1.1
3632
+GET /v1.24/plugins/tiborvass/no-remove:latest HTTP/1.1
3633 3633
 ```
3634 3634
 
3635 3635
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -3762,7 +3762,7 @@ Enables a plugin
3762 3762
 **Example request**:
3763 3763
 
3764 3764
 ```
3765
-POST /plugins/tiborvass/no-remove:latest/enable HTTP/1.1
3765
+POST /v1.24/plugins/tiborvass/no-remove:latest/enable HTTP/1.1
3766 3766
 ```
3767 3767
 
3768 3768
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -3790,7 +3790,7 @@ Disables a plugin
3790 3790
 **Example request**:
3791 3791
 
3792 3792
 ```
3793
-POST /plugins/tiborvass/no-remove:latest/disable HTTP/1.1
3793
+POST /v1.24/plugins/tiborvass/no-remove:latest/disable HTTP/1.1
3794 3794
 ```
3795 3795
 
3796 3796
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -3841,14 +3841,14 @@ Content-Type: text/plain; charset=utf-8
3841 3841
 
3842 3842
 ### Push a plugin
3843 3843
 
3844
-`POST /plugins/tiborvass/(plugin name)/push HTTP/1.1`
3844
+`POST /v1.24/plugins/tiborvass/(plugin name)/push HTTP/1.1`
3845 3845
 
3846 3846
 Pushes a plugin to the registry.
3847 3847
 
3848 3848
 **Example request**:
3849 3849
 
3850 3850
 ```
3851
-POST /plugins/tiborvass/no-remove:latest HTTP/1.1
3851
+POST /v1.24/plugins/tiborvass/no-remove:latest HTTP/1.1
3852 3852
 ```
3853 3853
 
3854 3854
 The `:latest` tag is optional, and is used as default if omitted. When using
... ...
@@ -3878,7 +3878,7 @@ List nodes
3878 3878
 
3879 3879
 **Example request**:
3880 3880
 
3881
-    GET /nodes HTTP/1.1
3881
+    GET /v1.24/nodes HTTP/1.1
3882 3882
 
3883 3883
 **Example response**:
3884 3884
 
... ...
@@ -3970,7 +3970,7 @@ Return low-level information on the node `id`
3970 3970
 
3971 3971
 **Example request**:
3972 3972
 
3973
-      GET /nodes/24ifsmvkjbyhk HTTP/1.1
3973
+      GET /v1.24/nodes/24ifsmvkjbyhk HTTP/1.1
3974 3974
 
3975 3975
 **Example response**:
3976 3976
 
... ...
@@ -4087,7 +4087,7 @@ an empty value or the default cluster-wide value.
4087 4087
 
4088 4088
 **Example Request**
4089 4089
 
4090
-    POST /nodes/24ifsmvkjbyhk/update?version=8 HTTP/1.1
4090
+    POST /v1.24/nodes/24ifsmvkjbyhk/update?version=8 HTTP/1.1
4091 4091
     Content-Type: application/json
4092 4092
 
4093 4093
     {
... ...
@@ -4185,7 +4185,7 @@ Initialize a new swarm. The body of the HTTP response includes the node ID.
4185 4185
 
4186 4186
 **Example request**:
4187 4187
 
4188
-    POST /swarm/init HTTP/1.1
4188
+    POST /v1.24/swarm/init HTTP/1.1
4189 4189
     Content-Type: application/json
4190 4190
 
4191 4191
     {
... ...
@@ -4260,7 +4260,7 @@ Join an existing swarm
4260 4260
 
4261 4261
 **Example request**:
4262 4262
 
4263
-    POST /swarm/join HTTP/1.1
4263
+    POST /v1.24/swarm/join HTTP/1.1
4264 4264
     Content-Type: application/json
4265 4265
 
4266 4266
     {
... ...
@@ -4303,7 +4303,7 @@ Leave a swarm
4303 4303
 
4304 4304
 **Example request**:
4305 4305
 
4306
-    POST /swarm/leave HTTP/1.1
4306
+    POST /v1.24/swarm/leave HTTP/1.1
4307 4307
 
4308 4308
 **Example response**:
4309 4309
 
... ...
@@ -4329,7 +4329,7 @@ Update a swarm
4329 4329
 
4330 4330
 **Example request**:
4331 4331
 
4332
-    POST /swarm/update HTTP/1.1
4332
+    POST /v1.24/swarm/update HTTP/1.1
4333 4333
 
4334 4334
     {
4335 4335
       "Name": "default",
... ...
@@ -4414,7 +4414,7 @@ List services
4414 4414
 
4415 4415
 **Example request**:
4416 4416
 
4417
-    GET /services HTTP/1.1
4417
+    GET /v1.24/services HTTP/1.1
4418 4418
 
4419 4419
 **Example response**:
4420 4420
 
... ...
@@ -4520,7 +4520,7 @@ image](#create-an-image) section for more details.
4520 4520
 
4521 4521
 **Example request**:
4522 4522
 
4523
-    POST /services/create HTTP/1.1
4523
+    POST /v1.24/services/create HTTP/1.1
4524 4524
     Content-Type: application/json
4525 4525
 
4526 4526
     {
... ...
@@ -4714,7 +4714,7 @@ Return information on the service `id`.
4714 4714
 
4715 4715
 **Example request**:
4716 4716
 
4717
-    GET /services/1cb4dnqcyx6m66g2t538x3rxha HTTP/1.1
4717
+    GET /v1.24/services/1cb4dnqcyx6m66g2t538x3rxha HTTP/1.1
4718 4718
 
4719 4719
 **Example response**:
4720 4720
 
... ...
@@ -4806,7 +4806,7 @@ image](#create-an-image) section for more details.
4806 4806
 
4807 4807
 **Example request**:
4808 4808
 
4809
-    POST /services/1cb4dnqcyx6m66g2t538x3rxha/update?version=23 HTTP/1.1
4809
+    POST /v1.24/services/1cb4dnqcyx6m66g2t538x3rxha/update?version=23 HTTP/1.1
4810 4810
     Content-Type: application/json
4811 4811
 
4812 4812
     {
... ...
@@ -4940,7 +4940,7 @@ List tasks
4940 4940
 
4941 4941
 **Example request**:
4942 4942
 
4943
-    GET /tasks HTTP/1.1
4943
+    GET /v1.24/tasks HTTP/1.1
4944 4944
 
4945 4945
 **Example response**:
4946 4946
 
... ...
@@ -5138,7 +5138,7 @@ Get details on a task
5138 5138
 
5139 5139
 **Example request**:
5140 5140
 
5141
-    GET /tasks/0kzzo1i0y4jz6027t0k7aezc7 HTTP/1.1
5141
+    GET /v1.24/tasks/0kzzo1i0y4jz6027t0k7aezc7 HTTP/1.1
5142 5142
 
5143 5143
 **Example response**:
5144 5144
 
... ...
@@ -46,7 +46,7 @@ List containers
46 46
 
47 47
 **Example request**:
48 48
 
49
-    GET /containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
49
+    GET /v1.25/containers/json?all=1&before=8dfafdbc3a40&size=1 HTTP/1.1
50 50
 
51 51
 **Example response**:
52 52
 
... ...
@@ -255,7 +255,7 @@ Create a container
255 255
 
256 256
 **Example request**:
257 257
 
258
-    POST /containers/create HTTP/1.1
258
+    POST /v1.25/containers/create HTTP/1.1
259 259
     Content-Type: application/json
260 260
 
261 261
     {
... ...
@@ -562,7 +562,7 @@ Return low-level information on the container `id`
562 562
 
563 563
 **Example request**:
564 564
 
565
-      GET /containers/4fa6e0f0c678/json HTTP/1.1
565
+      GET /v1.25/containers/4fa6e0f0c678/json HTTP/1.1
566 566
 
567 567
 **Example response**:
568 568
 
... ...
@@ -746,7 +746,7 @@ Return low-level information on the container `id`
746 746
 
747 747
 **Example request, with size information**:
748 748
 
749
-    GET /containers/4fa6e0f0c678/json?size=1 HTTP/1.1
749
+    GET /v1.25/containers/4fa6e0f0c678/json?size=1 HTTP/1.1
750 750
 
751 751
 **Example response, with size information**:
752 752
 
... ...
@@ -780,7 +780,7 @@ supported on Windows.
780 780
 
781 781
 **Example request**:
782 782
 
783
-    GET /containers/4fa6e0f0c678/top HTTP/1.1
783
+    GET /v1.25/containers/4fa6e0f0c678/top HTTP/1.1
784 784
 
785 785
 **Example response**:
786 786
 
... ...
@@ -803,7 +803,7 @@ supported on Windows.
803 803
 
804 804
 **Example request**:
805 805
 
806
-    GET /containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
806
+    GET /v1.25/containers/4fa6e0f0c678/top?ps_args=aux HTTP/1.1
807 807
 
808 808
 **Example response**:
809 809
 
... ...
@@ -845,7 +845,7 @@ Get `stdout` and `stderr` logs from the container ``id``
845 845
 
846 846
 **Example request**:
847 847
 
848
-     GET /containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
848
+     GET /v1.25/containers/4fa6e0f0c678/logs?stderr=1&stdout=1&timestamps=1&follow=1&tail=10&since=1428990821 HTTP/1.1
849 849
 
850 850
 **Example response**:
851 851
 
... ...
@@ -885,7 +885,7 @@ Inspect changes on container `id`'s filesystem
885 885
 
886 886
 **Example request**:
887 887
 
888
-    GET /containers/4fa6e0f0c678/changes HTTP/1.1
888
+    GET /v1.25/containers/4fa6e0f0c678/changes HTTP/1.1
889 889
 
890 890
 **Example response**:
891 891
 
... ...
@@ -927,7 +927,7 @@ Export the contents of container `id`
927 927
 
928 928
 **Example request**:
929 929
 
930
-    GET /containers/4fa6e0f0c678/export HTTP/1.1
930
+    GET /v1.25/containers/4fa6e0f0c678/export HTTP/1.1
931 931
 
932 932
 **Example response**:
933 933
 
... ...
@@ -952,7 +952,7 @@ This endpoint returns a live stream of a container's resource usage statistics.
952 952
 
953 953
 **Example request**:
954 954
 
955
-    GET /containers/redis1/stats HTTP/1.1
955
+    GET /v1.25/containers/redis1/stats HTTP/1.1
956 956
 
957 957
 **Example response**:
958 958
 
... ...
@@ -1076,7 +1076,7 @@ Resize the TTY for container with  `id`. The unit is number of characters. You m
1076 1076
 
1077 1077
 **Example request**:
1078 1078
 
1079
-      POST /containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
1079
+      POST /v1.25/containers/4fa6e0f0c678/resize?h=40&w=80 HTTP/1.1
1080 1080
 
1081 1081
 **Example response**:
1082 1082
 
... ...
@@ -1103,7 +1103,7 @@ Start the container `id`
1103 1103
 
1104 1104
 **Example request**:
1105 1105
 
1106
-    POST /containers/e90e34656806/start HTTP/1.1
1106
+    POST /v1.25/containers/e90e34656806/start HTTP/1.1
1107 1107
 
1108 1108
 **Example response**:
1109 1109
 
... ...
@@ -1130,7 +1130,7 @@ Stop the container `id`
1130 1130
 
1131 1131
 **Example request**:
1132 1132
 
1133
-    POST /containers/e90e34656806/stop?t=5 HTTP/1.1
1133
+    POST /v1.25/containers/e90e34656806/stop?t=5 HTTP/1.1
1134 1134
 
1135 1135
 **Example response**:
1136 1136
 
... ...
@@ -1155,7 +1155,7 @@ Restart the container `id`
1155 1155
 
1156 1156
 **Example request**:
1157 1157
 
1158
-    POST /containers/e90e34656806/restart?t=5 HTTP/1.1
1158
+    POST /v1.25/containers/e90e34656806/restart?t=5 HTTP/1.1
1159 1159
 
1160 1160
 **Example response**:
1161 1161
 
... ...
@@ -1179,7 +1179,7 @@ Kill the container `id`
1179 1179
 
1180 1180
 **Example request**:
1181 1181
 
1182
-    POST /containers/e90e34656806/kill HTTP/1.1
1182
+    POST /v1.25/containers/e90e34656806/kill HTTP/1.1
1183 1183
 
1184 1184
 **Example response**:
1185 1185
 
... ...
@@ -1204,7 +1204,7 @@ Update configuration of one or more containers.
1204 1204
 
1205 1205
 **Example request**:
1206 1206
 
1207
-       POST /containers/e90e34656806/update HTTP/1.1
1207
+       POST /v1.25/containers/e90e34656806/update HTTP/1.1
1208 1208
        Content-Type: application/json
1209 1209
 
1210 1210
        {
... ...
@@ -1250,7 +1250,7 @@ Rename the container `id` to a `new_name`
1250 1250
 
1251 1251
 **Example request**:
1252 1252
 
1253
-    POST /containers/e90e34656806/rename?name=new_name HTTP/1.1
1253
+    POST /v1.25/containers/e90e34656806/rename?name=new_name HTTP/1.1
1254 1254
 
1255 1255
 **Example response**:
1256 1256
 
... ...
@@ -1275,7 +1275,7 @@ Pause the container `id`
1275 1275
 
1276 1276
 **Example request**:
1277 1277
 
1278
-    POST /containers/e90e34656806/pause HTTP/1.1
1278
+    POST /v1.25/containers/e90e34656806/pause HTTP/1.1
1279 1279
 
1280 1280
 **Example response**:
1281 1281
 
... ...
@@ -1295,7 +1295,7 @@ Unpause the container `id`
1295 1295
 
1296 1296
 **Example request**:
1297 1297
 
1298
-    POST /containers/e90e34656806/unpause HTTP/1.1
1298
+    POST /v1.25/containers/e90e34656806/unpause HTTP/1.1
1299 1299
 
1300 1300
 **Example response**:
1301 1301
 
... ...
@@ -1315,7 +1315,7 @@ Attach to the container `id`
1315 1315
 
1316 1316
 **Example request**:
1317 1317
 
1318
-    POST /containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1318
+    POST /v1.25/containers/16253994b7c4/attach?logs=1&stream=0&stdout=1 HTTP/1.1
1319 1319
 
1320 1320
 **Example response**:
1321 1321
 
... ...
@@ -1406,7 +1406,7 @@ Implements websocket protocol handshake according to [RFC 6455](http://tools.iet
1406 1406
 
1407 1407
 **Example request**
1408 1408
 
1409
-    GET /containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1409
+    GET /v1.25/containers/e90e34656806/attach/ws?logs=0&stream=1&stdin=1&stdout=1&stderr=1 HTTP/1.1
1410 1410
 
1411 1411
 **Example response**
1412 1412
 
... ...
@@ -1444,7 +1444,7 @@ Block until container `id` stops, then returns the exit code
1444 1444
 
1445 1445
 **Example request**:
1446 1446
 
1447
-    POST /containers/16253994b7c4/wait HTTP/1.1
1447
+    POST /v1.25/containers/16253994b7c4/wait HTTP/1.1
1448 1448
 
1449 1449
 **Example response**:
1450 1450
 
... ...
@@ -1518,7 +1518,7 @@ Get a tar archive of a resource in the filesystem of container `id`.
1518 1518
 
1519 1519
 **Example request**:
1520 1520
 
1521
-    GET /containers/8cce319429b2/archive?path=/root HTTP/1.1
1521
+    GET /v1.25/containers/8cce319429b2/archive?path=/root HTTP/1.1
1522 1522
 
1523 1523
 **Example response**:
1524 1524
 
... ...
@@ -1617,7 +1617,7 @@ Delete stopped containers
1617 1617
 
1618 1618
 **Example request**:
1619 1619
 
1620
-    POST /containers/prune HTTP/1.1
1620
+    POST /v1.25/containers/prune HTTP/1.1
1621 1621
     Content-Type: application/json
1622 1622
 
1623 1623
     {
... ...
@@ -1648,7 +1648,7 @@ Delete stopped containers
1648 1648
 
1649 1649
 **Example request**:
1650 1650
 
1651
-    GET /images/json?all=0 HTTP/1.1
1651
+    GET /v1.25/images/json?all=0 HTTP/1.1
1652 1652
 
1653 1653
 **Example response**:
1654 1654
 
... ...
@@ -1686,7 +1686,7 @@ Delete stopped containers
1686 1686
 
1687 1687
 **Example request, with digest information**:
1688 1688
 
1689
-    GET /images/json?digests=1 HTTP/1.1
1689
+    GET /v1.25/v1.25/images/json?digests=1 HTTP/1.1
1690 1690
 
1691 1691
 **Example response, with digest information**:
1692 1692
 
... ...
@@ -1743,7 +1743,7 @@ Build an image from a Dockerfile
1743 1743
 
1744 1744
 **Example request**:
1745 1745
 
1746
-    POST /build HTTP/1.1
1746
+    POST /v1.25/v1.25/build HTTP/1.1
1747 1747
 
1748 1748
     {% raw %}
1749 1749
     {{ TAR STREAM }}
... ...
@@ -1856,7 +1856,7 @@ Create an image either by pulling it from the registry or by importing it
1856 1856
 
1857 1857
 **Example request**:
1858 1858
 
1859
-    POST /images/create?fromImage=busybox&tag=latest HTTP/1.1
1859
+    POST /v1.25/images/create?fromImage=busybox&tag=latest HTTP/1.1
1860 1860
 
1861 1861
 **Example response**:
1862 1862
 
... ...
@@ -1931,7 +1931,7 @@ Return low-level information on the image `name`
1931 1931
 
1932 1932
 **Example request**:
1933 1933
 
1934
-    GET /images/example/json HTTP/1.1
1934
+    GET /v1.25/images/example/json HTTP/1.1
1935 1935
 
1936 1936
 **Example response (Linux daemon)**:
1937 1937
 
... ...
@@ -2129,7 +2129,7 @@ Return the history of the image `name`
2129 2129
 
2130 2130
 **Example request**:
2131 2131
 
2132
-    GET /images/ubuntu/history HTTP/1.1
2132
+    GET /v1.25/images/ubuntu/history HTTP/1.1
2133 2133
 
2134 2134
 **Example response**:
2135 2135
 
... ...
@@ -2183,7 +2183,7 @@ Push the image `name` on the registry
2183 2183
 
2184 2184
 **Example request**:
2185 2185
 
2186
-    POST /images/test/push HTTP/1.1
2186
+    POST /v1.25/images/test/push HTTP/1.1
2187 2187
 
2188 2188
 **Example response**:
2189 2189
 
... ...
@@ -2203,7 +2203,7 @@ The push is cancelled if the HTTP connection is closed.
2203 2203
 
2204 2204
 **Example request**:
2205 2205
 
2206
-    POST /images/registry.acme.com:5000/test/push HTTP/1.1
2206
+    POST /v1.25/images/registry.acme.com:5000/test/push HTTP/1.1
2207 2207
 
2208 2208
 
2209 2209
 **Query parameters**:
... ...
@@ -2245,7 +2245,7 @@ Tag the image `name` into a repository
2245 2245
 
2246 2246
 **Example request**:
2247 2247
 
2248
-    POST /images/test/tag?repo=myrepo&tag=v42 HTTP/1.1
2248
+    POST /v1.25/images/test/tag?repo=myrepo&tag=v42 HTTP/1.1
2249 2249
 
2250 2250
 **Example response**:
2251 2251
 
... ...
@@ -2309,7 +2309,7 @@ Search for an image on [Docker Hub](https://hub.docker.com).
2309 2309
 
2310 2310
 **Example request**:
2311 2311
 
2312
-    GET /images/search?term=sshd HTTP/1.1
2312
+    GET /v1.25/images/search?term=sshd HTTP/1.1
2313 2313
 
2314 2314
 **Example response**:
2315 2315
 
... ...
@@ -2363,7 +2363,7 @@ Delete unused images
2363 2363
 
2364 2364
 **Example request**:
2365 2365
 
2366
-    POST /images/prune HTTP/1.1
2366
+    POST /v1.25/images/prune HTTP/1.1
2367 2367
     Content-Type: application/json
2368 2368
 
2369 2369
     {
... ...
@@ -2414,7 +2414,7 @@ if available, for accessing the registry without password.
2414 2414
 
2415 2415
 **Example request**:
2416 2416
 
2417
-    POST /auth HTTP/1.1
2417
+    POST /v1.25/auth HTTP/1.1
2418 2418
     Content-Type: application/json
2419 2419
 
2420 2420
     {
... ...
@@ -2446,7 +2446,7 @@ Display system-wide information
2446 2446
 
2447 2447
 **Example request**:
2448 2448
 
2449
-    GET /info HTTP/1.1
2449
+    GET /v1.25/info HTTP/1.1
2450 2450
 
2451 2451
 **Example response (Linux)**:
2452 2452
 
... ...
@@ -2659,7 +2659,7 @@ Return docker data usage information
2659 2659
 
2660 2660
 **Example request**:
2661 2661
 
2662
-    GET /system/df HTTP/1.1
2662
+    GET /v1.25/system/df HTTP/1.1
2663 2663
 
2664 2664
 **Example response**:
2665 2665
 
... ...
@@ -2751,7 +2751,7 @@ Show the docker version information
2751 2751
 
2752 2752
 **Example request**:
2753 2753
 
2754
-    GET /version HTTP/1.1
2754
+    GET /v1.25/version HTTP/1.1
2755 2755
 
2756 2756
 **Example response**:
2757 2757
 
... ...
@@ -2784,7 +2784,7 @@ Ping the docker server
2784 2784
 
2785 2785
 **Example request**:
2786 2786
 
2787
-    GET /_ping HTTP/1.1
2787
+    GET /v1.25/_ping HTTP/1.1
2788 2788
 
2789 2789
 **Example response**:
2790 2790
 
... ...
@@ -2806,7 +2806,7 @@ Create a new image from a container's changes
2806 2806
 
2807 2807
 **Example request**:
2808 2808
 
2809
-    POST /commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2809
+    POST /v1.25/commit?container=44c004db4b17&comment=message&repo=myrepo HTTP/1.1
2810 2810
     Content-Type: application/json
2811 2811
 
2812 2812
     {
... ...
@@ -3212,7 +3212,7 @@ Sets up an exec instance in a running container `id`
3212 3212
 
3213 3213
 **Example request**:
3214 3214
 
3215
-    POST /containers/e90e34656806/exec HTTP/1.1
3215
+    POST /v1.25/containers/e90e34656806/exec HTTP/1.1
3216 3216
     Content-Type: application/json
3217 3217
 
3218 3218
     {
... ...
@@ -3273,7 +3273,7 @@ interactive session with the `exec` command.
3273 3273
 
3274 3274
 **Example request**:
3275 3275
 
3276
-    POST /exec/e90e34656806/start HTTP/1.1
3276
+    POST /v1.25/exec/e90e34656806/start HTTP/1.1
3277 3277
     Content-Type: application/json
3278 3278
 
3279 3279
     {
... ...
@@ -3314,7 +3314,7 @@ This API is valid only if `tty` was specified as part of creating and starting t
3314 3314
 
3315 3315
 **Example request**:
3316 3316
 
3317
-    POST /exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
3317
+    POST /v1.25/exec/e90e34656806/resize?h=40&w=80 HTTP/1.1
3318 3318
     Content-Type: text/plain
3319 3319
 
3320 3320
 **Example response**:
... ...
@@ -3340,7 +3340,7 @@ Return low-level information about the `exec` command `id`.
3340 3340
 
3341 3341
 **Example request**:
3342 3342
 
3343
-    GET /exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
3343
+    GET /v1.25/exec/11fb006128e8ceb3942e7c58d77750f24210e35f879dd204ac975c184b820b39/json HTTP/1.1
3344 3344
 
3345 3345
 **Example response**:
3346 3346
 
... ...
@@ -3384,7 +3384,7 @@ Return low-level information about the `exec` command `id`.
3384 3384
 
3385 3385
 **Example request**:
3386 3386
 
3387
-    GET /volumes HTTP/1.1
3387
+    GET /v1.25/volumes HTTP/1.1
3388 3388
 
3389 3389
 **Example response**:
3390 3390
 
... ...
@@ -3432,7 +3432,7 @@ Create a volume
3432 3432
 
3433 3433
 **Example request**:
3434 3434
 
3435
-    POST /volumes/create HTTP/1.1
3435
+    POST /v1.25/volumes/create HTTP/1.1
3436 3436
     Content-Type: application/json
3437 3437
 
3438 3438
     {
... ...
@@ -3573,7 +3573,7 @@ Delete unused volumes
3573 3573
 
3574 3574
 **Example request**:
3575 3575
 
3576
-    POST /volumes/prune HTTP/1.1
3576
+    POST /v1.25/volumes/prune HTTP/1.1
3577 3577
     Content-Type: application/json
3578 3578
 
3579 3579
     {
... ...
@@ -3605,7 +3605,7 @@ Delete unused volumes
3605 3605
 
3606 3606
 **Example request**:
3607 3607
 
3608
-    GET /networks?filters={"type":{"custom":true}} HTTP/1.1
3608
+    GET /v1.25/networks?filters={"type":{"custom":true}} HTTP/1.1
3609 3609
 
3610 3610
 **Example response**:
3611 3611
 
... ...
@@ -3700,7 +3700,7 @@ Content-Type: application/json
3700 3700
 
3701 3701
 **Example request**:
3702 3702
 
3703
-    GET /networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3703
+    GET /v1.25/networks/7d86d31b1478e7cca9ebed7e73aa0fdeec46c5ca29497431d3007d2d9e15ed99 HTTP/1.1
3704 3704
 
3705 3705
 **Example response**:
3706 3706
 
... ...
@@ -3766,7 +3766,7 @@ Create a network
3766 3766
 **Example request**:
3767 3767
 
3768 3768
 ```
3769
-POST /networks/create HTTP/1.1
3769
+POST /v1.25/networks/create HTTP/1.1
3770 3770
 Content-Type: application/json
3771 3771
 
3772 3772
 {
... ...
@@ -3849,7 +3849,7 @@ Connect a container to a network
3849 3849
 **Example request**:
3850 3850
 
3851 3851
 ```
3852
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3852
+POST /v1.25/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/connect HTTP/1.1
3853 3853
 Content-Type: application/json
3854 3854
 
3855 3855
 {
... ...
@@ -3887,7 +3887,7 @@ Disconnect a container from a network
3887 3887
 **Example request**:
3888 3888
 
3889 3889
 ```
3890
-POST /networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3890
+POST /v1.25/networks/22be93d5babb089c5aab8dbc369042fad48ff791584ca2da2100db837a1c7c30/disconnect HTTP/1.1
3891 3891
 Content-Type: application/json
3892 3892
 
3893 3893
 {
... ...
@@ -3940,7 +3940,7 @@ Delete unused networks
3940 3940
 
3941 3941
 **Example request**:
3942 3942
 
3943
-    POST /networks/prune HTTP/1.1
3943
+    POST /v1.25/networks/prune HTTP/1.1
3944 3944
     Content-Type: application/json
3945 3945
 
3946 3946
     {
... ...
@@ -3972,7 +3972,7 @@ Returns information about installed plugins.
3972 3972
 
3973 3973
 **Example request**:
3974 3974
 
3975
-    GET /plugins HTTP/1.1
3975
+    GET /v1.25/plugins HTTP/1.1
3976 3976
 
3977 3977
 **Example response**:
3978 3978
 
... ...
@@ -4104,7 +4104,7 @@ using the [`POST /plugins/(plugin name)/enable` endpoint](#enable-a-plugin).
4104 4104
 **Example request**:
4105 4105
 
4106 4106
 ```
4107
-POST /plugins/pull?name=tiborvass/no-remove:latest HTTP/1.1
4107
+POST /v1.25/plugins/pull?name=tiborvass/no-remove:latest HTTP/1.1
4108 4108
 ```
4109 4109
 
4110 4110
 The `:latest` tag is optional, and is used as default if omitted. When using
... ...
@@ -4165,7 +4165,7 @@ Returns detailed information about an installed plugin.
4165 4165
 **Example request**:
4166 4166
 
4167 4167
 ```
4168
-GET /plugins/tiborvass/no-remove:latest HTTP/1.1
4168
+GET /v1.25/plugins/tiborvass/no-remove:latest HTTP/1.1
4169 4169
 ```
4170 4170
 
4171 4171
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -4319,7 +4319,7 @@ Enables a plugin
4319 4319
 **Example request**:
4320 4320
 
4321 4321
 ```
4322
-POST /plugins/tiborvass/no-remove:latest/enable HTTP/1.1
4322
+POST /v1.25/plugins/tiborvass/no-remove:latest/enable HTTP/1.1
4323 4323
 ```
4324 4324
 
4325 4325
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -4347,7 +4347,7 @@ Disables a plugin
4347 4347
 **Example request**:
4348 4348
 
4349 4349
 ```
4350
-POST /plugins/tiborvass/no-remove:latest/disable HTTP/1.1
4350
+POST /v1.25/plugins/tiborvass/no-remove:latest/disable HTTP/1.1
4351 4351
 ```
4352 4352
 
4353 4353
 The `:latest` tag is optional, and is used as default if omitted.
... ...
@@ -4404,14 +4404,14 @@ Content-Type: text/plain; charset=utf-8
4404 4404
 
4405 4405
 ### Push a plugin
4406 4406
 
4407
-`POST /plugins/tiborvass/(plugin name)/push HTTP/1.1`
4407
+`POST /v1.25/plugins/tiborvass/(plugin name)/push HTTP/1.1`
4408 4408
 
4409 4409
 Pushes a plugin to the registry.
4410 4410
 
4411 4411
 **Example request**:
4412 4412
 
4413 4413
 ```
4414
-POST /plugins/tiborvass/no-remove:latest HTTP/1.1
4414
+POST /v1.25/plugins/tiborvass/no-remove:latest HTTP/1.1
4415 4415
 ```
4416 4416
 
4417 4417
 The `:latest` tag is optional, and is used as default if omitted. When using
... ...
@@ -4441,7 +4441,7 @@ List nodes
4441 4441
 
4442 4442
 **Example request**:
4443 4443
 
4444
-    GET /nodes HTTP/1.1
4444
+    GET /v1.25/nodes HTTP/1.1
4445 4445
 
4446 4446
 **Example response**:
4447 4447
 
... ...
@@ -4534,7 +4534,7 @@ Return low-level information on the node `id`
4534 4534
 
4535 4535
 **Example request**:
4536 4536
 
4537
-      GET /nodes/24ifsmvkjbyhk HTTP/1.1
4537
+      GET /v1.25/nodes/24ifsmvkjbyhk HTTP/1.1
4538 4538
 
4539 4539
 **Example response**:
4540 4540
 
... ...
@@ -4652,7 +4652,7 @@ an empty value or the default cluster-wide value.
4652 4652
 
4653 4653
 **Example Request**
4654 4654
 
4655
-    POST /nodes/24ifsmvkjbyhk/update?version=8 HTTP/1.1
4655
+    POST /v1.25/nodes/24ifsmvkjbyhk/update?version=8 HTTP/1.1
4656 4656
     Content-Type: application/json
4657 4657
 
4658 4658
     {
... ...
@@ -4750,7 +4750,7 @@ Initialize a new swarm. The body of the HTTP response includes the node ID.
4750 4750
 
4751 4751
 **Example request**:
4752 4752
 
4753
-    POST /swarm/init HTTP/1.1
4753
+    POST /v1.25/swarm/init HTTP/1.1
4754 4754
     Content-Type: application/json
4755 4755
 
4756 4756
     {
... ...
@@ -4825,7 +4825,7 @@ Join an existing swarm
4825 4825
 
4826 4826
 **Example request**:
4827 4827
 
4828
-    POST /swarm/join HTTP/1.1
4828
+    POST /v1.25/swarm/join HTTP/1.1
4829 4829
     Content-Type: application/json
4830 4830
 
4831 4831
     {
... ...
@@ -4868,7 +4868,7 @@ Leave a swarm
4868 4868
 
4869 4869
 **Example request**:
4870 4870
 
4871
-    POST /swarm/leave HTTP/1.1
4871
+    POST /v1.25/swarm/leave HTTP/1.1
4872 4872
 
4873 4873
 **Example response**:
4874 4874
 
... ...
@@ -4894,7 +4894,7 @@ Update a swarm
4894 4894
 
4895 4895
 **Example request**:
4896 4896
 
4897
-    POST /swarm/update HTTP/1.1
4897
+    POST /v1.25/swarm/update HTTP/1.1
4898 4898
 
4899 4899
     {
4900 4900
       "Name": "default",
... ...
@@ -4979,7 +4979,7 @@ List services
4979 4979
 
4980 4980
 **Example request**:
4981 4981
 
4982
-    GET /services HTTP/1.1
4982
+    GET /v1.25/services HTTP/1.1
4983 4983
 
4984 4984
 **Example response**:
4985 4985
 
... ...
@@ -5088,7 +5088,7 @@ image](#create-an-image) section for more details.
5088 5088
 
5089 5089
 **Example request**:
5090 5090
 
5091
-    POST /services/create HTTP/1.1
5091
+    POST /v1.25/services/create HTTP/1.1
5092 5092
     Content-Type: application/json
5093 5093
 
5094 5094
     {
... ...
@@ -5299,7 +5299,7 @@ Return information on the service `id`.
5299 5299
 
5300 5300
 **Example request**:
5301 5301
 
5302
-    GET /services/1cb4dnqcyx6m66g2t538x3rxha HTTP/1.1
5302
+    GET /v1.25/services/1cb4dnqcyx6m66g2t538x3rxha HTTP/1.1
5303 5303
 
5304 5304
 **Example response**:
5305 5305
 
... ...
@@ -5391,7 +5391,7 @@ image](#create-an-image) section for more details.
5391 5391
 
5392 5392
 **Example request**:
5393 5393
 
5394
-    POST /services/1cb4dnqcyx6m66g2t538x3rxha/update?version=23 HTTP/1.1
5394
+    POST /v1.25/services/1cb4dnqcyx6m66g2t538x3rxha/update?version=23 HTTP/1.1
5395 5395
     Content-Type: application/json
5396 5396
 
5397 5397
     {
... ...
@@ -5550,7 +5550,7 @@ List tasks
5550 5550
 
5551 5551
 **Example request**:
5552 5552
 
5553
-    GET /tasks HTTP/1.1
5553
+    GET /v1.25/tasks HTTP/1.1
5554 5554
 
5555 5555
 **Example response**:
5556 5556
 
... ...
@@ -5748,7 +5748,7 @@ Get details on a task
5748 5748
 
5749 5749
 **Example request**:
5750 5750
 
5751
-    GET /tasks/0kzzo1i0y4jz6027t0k7aezc7 HTTP/1.1
5751
+    GET /v1.25/tasks/0kzzo1i0y4jz6027t0k7aezc7 HTTP/1.1
5752 5752
 
5753 5753
 **Example response**:
5754 5754