How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Docker Image API

The Image API from Docker — 15 operation(s) for image.

Docker Image API is one of 15 APIs that Docker publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Image. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

This API exposes 15 operations across 15 paths, and defines 22 schemas. It is described by OpenAPI 2.0, at version 1.54.

15 operations 15 paths 22 schemas 1 DELETE6 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.54
Resource Areas
1

Paths & Operations 15

Across 15 paths, the API surfaces 15 operations — 1 DELETE, 6 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

Image 15
GET
/images/json
List Images
ImageList 6 params → 200500
POST
/build
Build an image
ImageBuild 28 params → 200400500
POST
/build/prune
Delete builder cache
BuildPrune 5 params → 200500
POST
/images/create
Create an image
ImageCreate 9 params → 200404500
GET
/images/{name}/json
Inspect an image
ImageInspect 3 params → 200404500
GET
/images/{name}/history
Get the history of an image
ImageHistory 2 params → 200404500
POST
/images/{name}/push
Push an image
ImagePush 4 params → 200404500
POST
/images/{name}/tag
Tag an image
ImageTag 3 params → 201400404409500
DELETE
/images/{name}
Remove an image
ImageDelete 4 params → 200404409500
GET
/images/search
Search images
ImageSearch 3 params → 200500
POST
/images/prune
Delete unused images
ImagePrune 1 param → 200500
POST
/commit
Create a new image from a container
ImageCommit 8 params → 201404500
GET
/images/{name}/get
Export an image
ImageGet 2 params → 200500
GET
/images/get
Export several images
ImageGetAll 2 params → 200500
POST
/images/load
Import images
ImageLoad 3 params → 200500

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are ContainerConfig (24 properties), ImageInspect (18 properties), SignerIdentity (17 properties), ImageConfig (13 properties). Each schema is shown below with its type and property counts.

SignatureType
string
SignatureType is the type of signature format.
ImageDeleteResponseItem
object
2 properties
DriverData
object
Information about the storage driver used to store the container's and image's filesystem.
2 properties 2 required
ImageSummary
object
11 properties 9 required
SignatureTimestampType
string
SignatureTimestampType is the type of timestamp used in the signature.
HealthConfig
object
A test to perform to check that the container is healthy. Healthcheck commands should be side-effect free.
6 properties
OCIDescriptor
object
A descriptor struct containing digest, media type, and size, as defined in the [OCI Content Descriptors Specification](https://github.com/opencontainers/image-…
8 properties
ImageConfig
object
Configuration of the image. These fields are used as defaults when starting a container from the image.
13 properties
KnownSignerIdentity
string
KnownSignerIdentity is an identifier for a special signer identity that is known to the implementation.
ImageHistoryResponseItem
object
individual image layer information in response to ImageHistory operation
6 properties 6 required
ImageManifestSummary
object
ImageManifestSummary represents a summary of an image manifest.
7 properties 5 required
Identity
object
Identity holds information about the identity and origin of the image. This is trusted information verified by the daemon and cannot be modified by tagging an…
3 properties
SignatureIdentity
object
SignatureIdentity contains the properties of verified signatures for the image.
8 properties
SignatureTimestamp
object
SignatureTimestamp contains information about a verified signed timestamp for an image signature.
3 properties
IDResponse
object
Response to an API call that returns just an Id
1 property 1 required
ImageInspect
object
Information about an image in the local image cache.
18 properties
ContainerConfig
object
Configuration for a container that is portable between hosts.
24 properties
OCIPlatform
object
Describes the platform which the image in the manifest runs on, as defined in the [OCI Image Index Specification](https://github.com/opencontainers/image-spec/…
5 properties
SignerIdentity
object
SignerIdentity contains information about the signer certificate used to sign the image.
17 properties
BuildIdentity
object
BuildIdentity contains build reference information if image was created via build.
2 properties
PullIdentity
object
PullIdentity contains remote location information if image was created via pull. If image was pulled via mirror, this contains the original repository location.
1 property
ErrorResponse
object
Represents an error.
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

docker-image-api-openapi.yml Raw ↑

Other APIs Docker publishes across the network.

Docker Config API
Docker Container API
Docker Distribution API
Docker Exec API
Docker Network API
Docker Node API
Docker Plugin API
Docker Secret API
Docker Service API
Docker Session API
Docker Swarm API
Docker System API
Where this information came from

This is an independent, third-party profile of Docker Image API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.