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 Container API

Create and manage containers.

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

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

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

25 operations 23 paths 47 schemas 1 DELETE9 GET1 HEAD13 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.54
Resource Areas
1

Paths & Operations 25

Across 23 paths, the API surfaces 25 operations — 1 DELETE, 9 GET, 1 HEAD, 13 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Container 25

Create and manage containers.

GET
/containers/json
List containers
ContainerList 4 params → 200400500
POST
/containers/create
Create a container
ContainerCreate 3 params → 201400404409500
GET
/containers/{id}/json
Inspect a container
ContainerInspect 2 params → 200404500
GET
/containers/{id}/top
List processes running inside a container
ContainerTop 2 params → 200404500
GET
/containers/{id}/logs
Get container logs
ContainerLogs 8 params → 200404500
GET
/containers/{id}/changes
Get changes on a container’s filesystem
ContainerChanges 1 param → 200404500
GET
/containers/{id}/export
Export a container
ContainerExport 1 param → 200404500
GET
/containers/{id}/stats
Get container stats based on resource usage
ContainerStats 3 params → 200404500
POST
/containers/{id}/resize
Resize a container TTY
ContainerResize 3 params → 200404500
POST
/containers/{id}/start
Start a container
ContainerStart 2 params → 204304404500
POST
/containers/{id}/stop
Stop a container
ContainerStop 3 params → 204304404500
POST
/containers/{id}/restart
Restart a container
ContainerRestart 3 params → 204404500
POST
/containers/{id}/kill
Kill a container
ContainerKill 2 params → 204404409500
POST
/containers/{id}/update
Update a container
ContainerUpdate 2 params → 200404500
POST
/containers/{id}/rename
Rename a container
ContainerRename 2 params → 204404409500
POST
/containers/{id}/pause
Pause a container
ContainerPause 1 param → 204404500
POST
/containers/{id}/unpause
Unpause a container
ContainerUnpause 1 param → 204404500
POST
/containers/{id}/attach
Attach to a container
ContainerAttach 7 params → 101200400404500
GET
/containers/{id}/attach/ws
Attach to a container via a websocket
ContainerAttachWebsocket 7 params → 101200400404500
POST
/containers/{id}/wait
Wait for a container
ContainerWait 2 params → 200400404500
DELETE
/containers/{id}
Remove a container
ContainerDelete 4 params → 204400404409500
HEAD
/containers/{id}/archive
Get information about files in a container
ContainerArchiveInfo 2 params → 200400404500
GET
/containers/{id}/archive
Get an archive of a filesystem resource in a container
ContainerArchive 2 params → 200400404500
PUT
/containers/{id}/archive
Extract an archive of files or folders to a directory in a container
PutContainerArchive 5 params → 200400403404500
POST
/containers/prune
Delete stopped containers
ContainerPrune 1 param → 200500

Schemas 47

The contract defines 47 schemas that model the data the API accepts and returns. The most detailed are Resources (30 properties), ContainerInspectResponse (27 properties), ContainerConfig (24 properties), ContainerSummary (17 properties). Each schema is shown below with its type and property counts.

NetworkingConfig
object
NetworkingConfig represents the container's networking configuration for each of its interfaces. It is used for the networking configs specified in the docker…
1 property
ContainerPidsStats
object
PidsStats contains Linux-specific stats of a container's process-IDs (PIDs). This type is Linux-specific and omitted for Windows containers.
2 properties
ContainerCPUStats
object
CPU related info of the container
4 properties
ContainerUpdateResponse
object
Response for a successful container-update.
1 property
PortMap
object
PortMap describes the mapping of container ports to host ports, using the container's port-number and protocol as key in the format / , for example, 80/udp. If…
DriverData
object
Information about the storage driver used to store the container's and image's filesystem.
2 properties 2 required
ChangeType
integer
Kind of change Can be one of: - 0: Modified ("C") - 1: Added ("A") - 2: Deleted ("D")
ContainerCPUUsage
object
All CPU stats aggregated since container inception.
4 properties
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
DeviceRequest
object
A request for devices to be sent to device drivers
5 properties
RestartPolicy
object
The behavior to apply when the container exits. The default is not to restart. An ever increasing delay (double the previous delay, starting at 100ms) is added…
2 properties
Resources
object
A container's resources (cgroups config, ulimits, etc)
30 properties
ContainerStorageStats
object
StorageStats is the disk I/O stats for read/write on Windows. This type is Windows-specific and omitted for Linux containers.
4 properties
HealthcheckResult
object
HealthcheckResult stores information about a single run of a healthcheck probe
4 properties
ContainerCreateResponse
object
OK response to ContainerCreate operation
2 properties 2 required
ContainerStatsResponse
object
Statistics sample for a container.
13 properties
HostConfig
Container configuration that depends on the host we are running on
ThrottleDevice
object
2 properties
FilesystemChange
object
Change in the container's filesystem.
2 properties 2 required
ContainerBlkioStats
object
BlkioStats stores all IO service stats for data read and write. This type is Linux-specific and holds many fields that are specific to cgroups v1. On a cgroup…
8 properties
Storage
object
Information about the storage used by the container.
1 property
ContainerState
object
ContainerState stores container's running state. It's part of ContainerJSONBase and will be returned by the "inspect" command.
12 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
ContainerSummary
object
17 properties
ContainerBlkioStatEntry
object
Blkio stats entry. This type is Linux-specific and omitted for Windows containers.
4 properties
ContainerThrottlingData
object
CPU throttling stats of the container. This type is Linux-specific and omitted for Windows containers.
3 properties
ContainerInspectResponse
object
27 properties
EndpointSettings
object
Configuration for a network endpoint.
15 properties
MountType
string
The mount type. Available types: - bind a mount of a file or directory from the host into the container. - cluster a Swarm cluster volume. - image an OCI image…
RootFSStorage
object
Information about the storage used for the container's root filesystem.
1 property
PortSummary
object
Describes a port-mapping between the container and the host.
4 properties 2 required
RootFSStorageSnapshot
object
Information about a snapshot backend of the container's root filesystem.
1 property
PortBinding
object
PortBinding represents a binding between a host IP address and a host port.
2 properties
Health
object
Health stores information about the container's healthcheck results.
3 properties
ContainerWaitResponse
object
OK response to ContainerWait operation
2 properties 1 required
MountPoint
object
MountPoint represents a mount point configuration inside the container. This is used for reporting the mountpoints in use by a container.
8 properties
NetworkSettings
object
NetworkSettings exposes the network settings in the API
4 properties
ContainerNetworkStats
object
Aggregates the network stats of one container
10 properties
ErrorResponse
object
Represents an error.
1 property 1 required
Mount
object
9 properties
DeviceMapping
object
A device mapping between the host and container
3 properties
EndpointIPAMConfig
object
EndpointIPAMConfig represents an endpoint's IPAM configuration.
3 properties
ContainerWaitExitError
object
container waiting error, if any
1 property
ContainerMemoryStats
object
Aggregates all memory stats since container inception on Linux. Windows returns stats for commit and private working set only.
8 properties
ContainerTopResponse
object
Container "top" response.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

docker-container-api-openapi.yml Raw ↑

Other APIs Docker publishes across the network.

Docker Config API
Docker Distribution API
Docker Exec API
Docker Image 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 Container 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.