v1
latestSwagger 2.02026-07-17107130444.8 KBCreate an image
Pull or import an image.
Query parameters
Name of the image to pull. If the name includes a tag or digest, specific behavior applies:
- If only fromImage includes a tag, that tag is used.
- If both fromImage and tag are provided, tag takes precedence.
- If fromImage includes a digest, the image is pulled by digest, and tag is ignored.
- If neither a tag nor digest is specified, all tags are pulled.
Source to import. The value may be a URL from which the image can be retrieved or - to read the image from the request body. This parameter may only be used when importing an image.
Repository name given to an image when it is imported. The repo may include a tag. This parameter may only be used when importing an image.
Tag or digest. If empty when pulling an image, this causes all tags for the given image to be pulled.
Set commit message for imported image.
Apply Dockerfile instructions to the image that is created, for example: changes=ENV DEBUG=true. Note that ENV DEBUG=true should be URI component encoded.
Supported Dockerfile instructions: CMD|ENTRYPOINT|ENV|EXPOSE|ONBUILD|USER|VOLUME|WORKDIR
Platform in the format os[/arch[/variant]].
When used in combination with the fromImage option, the daemon checks if the given image is present in the local image cache with the given OS and Architecture, and otherwise attempts to pull the image. If the option is not set, the host's native OS and Architecture are used. If the given image does not exist in the local image cache, the daemon attempts to pull the image with the host's native OS and Architecture. If the given image does exists in the local image cache, but its OS or architecture does not match, a warning is produced.
When used with the fromSrc option to import an image from an archive, this option sets the platform information for the imported image. If the option is not set, the host's native OS and Architecture are used for the imported image.
Headers
A base64url-encoded auth configuration.
Refer to the authentication section for details.
Response
no error