@@ -848,6 +848,60 @@ Query Parameters:

 -   **filters** – a json encoded value of the filters (a map[string][]string) to process on the images list. Available filters:

   -   dangling=true

+### Build image from a Dockerfile

+

+`POST /build`

+

+Build an image from a Dockerfile

+

+**Example request**:

+

+        POST /build HTTP/1.1

+

+        {{ TAR STREAM }}

+

+**Example response**:

+

+        HTTP/1.1 200 OK

+        Content-Type: application/json

+

+        {"stream": "Step 1..."}

+        {"stream": "..."}

+        {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}}

+

+The input stream must be a tar archive compressed with one of the

+following algorithms: identity (no compression), gzip, bzip2, xz.

+

+The archive must include a build instructions file, typically called

+`Dockerfile` at the root of the archive. The `dockerfile` parameter may be

+used to specify a different build instructions file by having its value be

+the path to the alternate build instructions file to use.

+

+The archive may include any number of other files,

+which will be accessible in the build context (See the [*ADD build

+command*](/reference/builder/#dockerbuilder)).

+

+Query Parameters:

+

+-   **dockerfile** - path within the build context to the Dockerfile

+-   **t** – repository name (and optionally a tag) to be applied to

+        the resulting image in case of success

+-   **q** – suppress verbose build output

+-   **nocache** – do not use the cache when building the image

+-   **pull** - attempt to pull the image even if an older image exists locally

+-   **rm** - remove intermediate containers after a successful build (default behavior)

+-   **forcerm** - always remove intermediate containers (includes rm)

+

+    Request Headers:

+

+-   **Content-type** – should be set to `"application/tar"`.

+-   **X-Registry-Config** – base64-encoded ConfigFile objec

+

+Status Codes:

+

+-   **200** – no error

+-   **500** – server error

+

 ### Create an image

 `POST /images/create`

@@ -1136,60 +1190,6 @@ Status Codes:

 ## 2.3 Misc

-### Build an image from Dockerfile via stdin

-

-`POST /build`

-

-Build an image from Dockerfile via stdin

-

-**Example request**:

-

-        POST /build HTTP/1.1

-

-        {{ TAR STREAM }}

-

-**Example response**:

-

-        HTTP/1.1 200 OK

-        Content-Type: application/json

-

-        {"stream": "Step 1..."}

-        {"stream": "..."}

-        {"error": "Error...", "errorDetail": {"code": 123, "message": "Error..."}}

-

-The input stream must be a tar archive compressed with one of the

-following algorithms: identity (no compression), gzip, bzip2, xz.

-

-The archive must include a build instructions file, typically called

-`Dockerfile` at the root of the archive. The `f` parameter may be used

-to specify a different build instructions file by having its value be

-the path to the alternate build instructions file to use.

-

-The archive may include any number of other files,

-which will be accessible in the build context (See the [*ADD build

-command*](/reference/builder/#dockerbuilder)).

-

-Query Parameters:

-

--   **dockerfile** - path within the build context to the Dockerfile

--   **t** – repository name (and optionally a tag) to be applied to

-        the resulting image in case of success

--   **q** – suppress verbose build output

--   **nocache** – do not use the cache when building the image

--   **pull** - attempt to pull the image even if an older image exists locally

--   **rm** - remove intermediate containers after a successful build (default behavior)

--   **forcerm** - always remove intermediate containers (includes rm)

-

-    Request Headers:

-

--   **Content-type** – should be set to `"application/tar"`.

--   **X-Registry-Config** – base64-encoded ConfigFile objec

-

-Status Codes:

-

--   **200** – no error

--   **500** – server error

-

 ### Check auth configuration

 `POST /auth`