# Docker Hub Container API

**Canonical:** https://apis.io/apis/docker-hub/docker-hub-container-api/  
**Provider:** Docker Hub — https://apis.io/providers/docker-hub/  
**Base URL:** https://hub.docker.com/v2  
**Documentation:** https://docs.docker.com/docker-hub/api/latest/

Docker Hub Container API is one of 26 APIs that [Docker Hub](https://apis.io/providers/docker-hub/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Containers. The published artifact set on APIs.io includes an OpenAPI specification.

Create and manage containers.

## Operations (25)

| Method | Path | Summary |
|---|---|---|
| GET | `/containers/json` | List containers |
| POST | `/containers/create` | Create a container |
| GET | `/containers/{id}/json` | Inspect a container |
| GET | `/containers/{id}/top` | List processes running inside a container |
| GET | `/containers/{id}/logs` | Get container logs |
| GET | `/containers/{id}/changes` | Get changes on a container’s filesystem |
| GET | `/containers/{id}/export` | Export a container |
| GET | `/containers/{id}/stats` | Get container stats based on resource usage |
| POST | `/containers/{id}/resize` | Resize a container TTY |
| POST | `/containers/{id}/start` | Start a container |
| POST | `/containers/{id}/stop` | Stop a container |
| POST | `/containers/{id}/restart` | Restart a container |
| POST | `/containers/{id}/kill` | Kill a container |
| POST | `/containers/{id}/update` | Update a container |
| POST | `/containers/{id}/rename` | Rename a container |
| POST | `/containers/{id}/pause` | Pause a container |
| POST | `/containers/{id}/unpause` | Unpause a container |
| POST | `/containers/{id}/attach` | Attach to a container |
| GET | `/containers/{id}/attach/ws` | Attach to a container via a websocket |
| POST | `/containers/{id}/wait` | Wait for a container |
| DELETE | `/containers/{id}` | Remove a container |
| HEAD | `/containers/{id}/archive` | Get information about files in a container |
| GET | `/containers/{id}/archive` | Get an archive of a filesystem resource in a container |
| PUT | `/containers/{id}/archive` | Extract an archive of files or folders to a directory in a container |
| POST | `/containers/prune` | Delete stopped containers |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/docker-hub/openapi/docker-hub-container-api-openapi.yml

## Other Docker Hub APIs (12)

- [Docker Hub Access Tokens API](https://apis.io/apis/docker-hub/docker-hub-access-tokens-api/)
- [Docker Hub Audit Logs API](https://apis.io/apis/docker-hub/docker-hub-audit-logs-api/)
- [Docker Hub Authentication API](https://apis.io/apis/docker-hub/docker-hub-authentication-api-api/)
- [Docker Hub Groups API](https://apis.io/apis/docker-hub/docker-hub-groups-api/)
- [Docker Hub Invites API](https://apis.io/apis/docker-hub/docker-hub-invites-api/)
- [Docker Hub Org Access Tokens API](https://apis.io/apis/docker-hub/docker-hub-org-access-tokens-api/)
- [Docker Hub Org Settings API](https://apis.io/apis/docker-hub/docker-hub-org-settings-api/)
- [Docker Hub Orgs API](https://apis.io/apis/docker-hub/docker-hub-orgs-api/)
- [Docker Hub Repositories API](https://apis.io/apis/docker-hub/docker-hub-repositories-api/)
- [Docker Hub SCIM API](https://apis.io/apis/docker-hub/docker-hub-scim-api/)
- [Docker Hub Config API](https://apis.io/apis/docker-hub/docker-hub-config-api/)
- [Docker Hub Distribution API](https://apis.io/apis/docker-hub/docker-hub-distribution-api/)

## Tags

Containers

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/docker-hub/docker-hub-container-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/docker-hub/.
