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

Podman containers API

Actions related to containers

Podman containers API is one of 18 APIs that Podman publishes on the 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, API documentation, and a getting-started guide.

This API exposes 37 operations across 36 paths, and defines 80 schemas. It is described by OpenAPI 3.2.0, at version 5.0.0.

Requests are made against 2 base URLs: http://podman.io/, https://podman.io/.

37 operations 36 paths 80 schemas 2 DELETE13 GET21 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
5.0.0
Base URL
http://d/v6.0.0/libpod
Contact
License
Terms of Service
Resource Areas
1

Paths & Operations 37

Across 36 paths, the API surfaces 37 operations — 2 DELETE, 13 GET, 21 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

containers 37

Actions related to containers

POST
/libpod/commit
Commit
ImageCommitLibpod 10 params → 201404500
DELETE
/libpod/containers/{name}
Delete container
ContainerDeleteLibpod 6 params → 200204400404409500
PUT
/libpod/containers/{name}/archive
Copy files into a container
PutContainerArchiveLibpod 3 params body → 200400403404500
POST
/libpod/containers/{name}/attach
Attach to a container
ContainerAttachLibpod 7 params → 101400404500
GET
/libpod/containers/{name}/changes
Report on changes to container's filesystem; adds, deletes or modifications.
ContainerChangesLibpod 3 params → 200404500
POST
/libpod/containers/{name}/checkpoint
Checkpoint a container
ContainerCheckpointLibpod 11 params → 200404500
GET
/libpod/containers/{name}/exists
Check if container exists
ContainerExistsLibpod 1 param → 204404500
GET
/libpod/containers/{name}/export
Export a container
ContainerExportLibpod 1 param → 200404500
GET
/libpod/containers/{name}/healthcheck
Run a container's healthcheck
ContainerHealthcheckLibpod 1 param → 200404409500
POST
/libpod/containers/{name}/init
Initialize a container
ContainerInitLibpod 1 param → 204304404500
GET
/libpod/containers/{name}/json
Inspect container
ContainerInspectLibpod 2 params → 200404500
POST
/libpod/containers/{name}/kill
Kill container
ContainerKillLibpod 2 params → 204404409500
GET
/libpod/containers/{name}/logs
Get container logs
ContainerLogsLibpod 8 params → 200404500
POST
/libpod/containers/{name}/mount
Mount a container
ContainerMountLibpod 2 params → 200404500
POST
/libpod/containers/{name}/pause
Pause a container
ContainerPauseLibpod 1 param → 204404500
POST
/libpod/containers/{name}/rename
Rename an existing container
ContainerRenameLibpod 2 params → 204404409500
POST
/libpod/containers/{name}/resize
Resize a container's TTY
ContainerResizeLibpod 4 params → 200404409500
POST
/libpod/containers/{name}/restart
Restart a container
ContainerRestartLibpod 3 params → 204404500
POST
/libpod/containers/{name}/restore
Restore a container
ContainerRestoreLibpod 13 params → 200404500
POST
/libpod/containers/{name}/start
Start a container
ContainerStartLibpod 2 params → 204304404500
GET
/libpod/containers/{name}/stats
Get stats for a container
ContainerStatsLibpod 2 params → 200404409500
POST
/libpod/containers/{name}/stop
Stop a container
ContainerStopLibpod 3 params → 204304404500
GET
/libpod/containers/{name}/top
List processes
ContainerTopLibpod 4 params → 200404500
POST
/libpod/containers/{name}/unmount
Unmount a container
ContainerUnmountLibpod 1 param → 204404500
POST
/libpod/containers/{name}/unpause
Unpause Container
ContainerUnpauseLibpod 1 param → 204404500
POST
/libpod/containers/{name}/update
Updates the configuration of an existing container, allowing changes to resource limits and healthchecks
ContainerUpdateLibpod 3 params body → 201400404500
POST
/libpod/containers/{name}/wait
Wait on a container
ContainerWaitLibpod 3 params → 200404500
POST
/libpod/containers/create
Create a container
ContainerCreateLibpod body → 201400404409500
GET
/libpod/containers/json
List containers
ContainerListLibpod 9 params → 200400500
POST
/libpod/containers/prune
Delete stopped containers
ContainerPruneLibpod 1 param → 200500
GET
/libpod/containers/showmounted
Show mounted containers
ContainerShowMountedLibpod → 200500
GET
/libpod/containers/stats
Get stats for one or more containers
ContainersStatsAllLibpod 4 params → 200404500
GET
/libpod/generate/{name}/systemd
Generate Systemd Units
GenerateSystemdLibpod 16 params → 200500
GET
/libpod/generate/kube
Generate a Kubernetes YAML file.
GenerateKubeLibpod 6 params → 200500
POST
/libpod/kube/apply
Apply a podman workload or Kubernetes YAML file.
KubeApplyLibpod 5 params body → 200500
DELETE
/libpod/play/kube
Remove resources created from kube play
PlayKubeDownLibpod 1 param → 200500
POST
/libpod/play/kube
Play a Kubernetes YAML file.
PlayKubeLibpod 18 params body → 200500

Schemas 80

The contract defines 80 schemas that model the data the API accepts and returns. The most detailed are SpecGenerator (125 properties), InspectContainerHostConfig (71 properties), InspectContainerData (42 properties), InspectContainerConfig (37 properties). Each schema is shown below with its type and property counts.

UpdateEntities
object
UpdateEntities used to wrap the oci resource spec in a swagger model
32 properties
LinuxThrottleDevice
object
LinuxThrottleDevice struct holds a major:minor ratepersecond pair
3 properties
Namespace
object
Namespace describes the namespace
2 properties
InspectBlkioThrottleDevice
object
InspectBlkioThrottleDevice holds information about a speed cap for a device node. This cap applies to a specific operation (read, write, etc) on the given node.
2 properties
LinuxInterfacePriority
object
LinuxInterfacePriority for network interfaces
2 properties
ContainersPruneReportLibpod
object
3 properties
AutoUserNsOptions
object
6 properties
TmpfsOptions
object
3 properties
WeightDevice
object
WeightDevice is a structure that holds device:weight pair
2 properties
ArtifactVolume
object
ArtifactVolume is a volume based on a artifact. The artifact blobs will be bind mounted directly as files and must always be read only.
5 properties
InspectUlimit
object
3 properties
NamespaceMode
string
InspectAdditionalNetwork
object
InspectAdditionalNetwork holds information about non-default networks the container has been connected to. As with InspectNetworkSettings, many fields are unus…
16 properties
ThrottleDevice
object
ThrottleDevice is a structure that holds device:ratepersecond pair
2 properties
LinuxRdma
object
LinuxRdma for Linux cgroup 'rdma' resource management (Linux 4.11)
2 properties
ContainerStats
object
ContainerStats contains the statistics information for a running container
16 properties
LinuxDeviceCgroup
object
LinuxDeviceCgroup represents a device rule for the devices specified to the device controller
5 properties
LinuxMemory
object
LinuxMemory for Linux cgroup 'memory' resource management
9 properties
ClusterOptions
object
InspectHostPort
object
InspectHostPort provides information on a port on the host that a container's port is bound to.
2 properties
POSIXRlimit
object
POSIXRlimit type and restrictions
3 properties
LibpodContainersRmReport
object
2 properties
InspectDevice
object
3 properties
IDMappingOptions
object
IDMappingOptions are used for specifying how ID mapping should be set up for a layer or container.
6 properties
LinuxWeightDevice
object
LinuxWeightDevice struct holds a major:minor weight pair for weightDevice
4 properties
LinuxDevice
object
LinuxDevice represents the mknod information for a Linux special device file
7 properties
ContainerTopOKBody
object
2 properties
OverlayVolume
object
OverlayVolume holds information about an overlay volume that will be mounted into the container.
3 properties
Schema2HealthConfig
object
Schema2HealthConfig is a HealthConfig, which holds configuration settings for the HEALTHCHECK feature, from docker/docker/api/types/container.
6 properties
PerNetworkOptions
object
5 properties
LinuxPersonalityDomain
string
LinuxCPU
object
LinuxCPU for Linux cgroup 'cpu' resource management
9 properties
Address
object
2 properties
HealthCheckLog
object
HealthCheckLog describes the results of a single healthcheck
4 properties
InspectLogConfig
object
InspectLogConfig holds information about a container's configured log driver
5 properties
ListContainer
object
ListContainer describes a container suitable for listing
InspectContainerHostConfig
object
InspectContainerHostConfig holds information used when the container was created. It's very much a Docker-specific struct, retained (mostly) as-is for compatib…
71 properties
StartupHealthCheck
object
7 properties
InspectNetworkSettings
object
InspectNetworkSettings holds information about the network settings of the container. Many fields are maintained only for compatibility with docker inspect and…
19 properties
LogConfigLibpod
object
LogConfig describes the logging characteristics for a container
5 properties
InspectRestartPolicy
object
2 properties
NamedVolume
object
NamedVolume holds information about a named volume that will be mounted into the container.
5 properties
LinuxBlockIO
object
LinuxBlockIO for Linux cgroup 'blkio' resource management
7 properties
FileMode
integer
The bits have the same definition on all systems, so that information about files can be moved from one system to another portably. Not all bits apply to all s…
Consistency
string
InspectSecret
object
InspectSecret contains information on secrets mounted inside the container
5 properties
LinuxResources
object
LinuxResources has container runtime resource constraints
9 properties
InspectMount
object
InspectMount provides a record of a single mount in a container. It contains fields for both named and normal volumes. Only user-specified volumes will be incl…
10 properties
LinuxPersonalityFlag
string
InspectContainerState
object
InspectContainerState provides a detailed record of a container's current state. It is returned as part of InspectContainerData. As with InspectContainerData,…
23 properties
ImageVolume
object
ImageVolume is a volume based on a container image. The container image is first mounted on the host and is then bind-mounted into the container. An ImageVolum…
4 properties
VolumeOptions
object
4 properties
DriverData
object
DriverData handles the data for a storage driver
2 properties 2 required
Mount
object
10 properties
InspectContainerData
object
InspectContainerData provides a detailed record of a container's configuration and state as viewed by Libpod. Large portions of this structure are defined such…
42 properties
InspectIDMappings
object
2 properties
LinuxHugepageLimit
object
Default to reservation limits if supported. Otherwise fallback to page fault limits.
2 properties
LinuxPids
object
LinuxPids for Linux cgroup 'pids' resource management (Linux 4.3)
1 property
ContainerCreateResponse
object
ContainerCreateResponse is the response struct for creating a container
SpecGenerator
object
SpecGenerator creates an OCI spec and Libpod configuration options to create a container based on the given configuration.
125 properties
Propagation
string
Secret
object
5 properties
InspectBlkioWeightDevice
object
InspectBlkioWeightDevice holds information about the relative weight of an individual device node. Weights are used in the I/O scheduler to give relative prior…
2 properties
LinuxPersonality
object
LinuxPersonality represents the Linux personality syscall input
2 properties
LinuxNetwork
object
LinuxNetwork identification and priority configuration
2 properties
Driver
object
2 properties
InspectContainerConfig
object
InspectContainerConfig holds further data about how a container was initially configured.
37 properties
Duration
integer
A Duration represents the elapsed time between two instants as an int64 nanosecond count. The representation limits the largest representable duration to appro…
Type
string
PlayKubeReport
object
LinuxIntelRdt
object
LinuxIntelRdt has container runtime resource constraints for Intel RDT CAT and MBA features and flags enabling Intel RDT CMT and MBM features. Intel RDT featur…
5 properties
ErrorModel
object
ErrorModel is used in remote connections with podman
3 properties
Signal
integer
It implements the [os.Signal] interface.
IDMap
object
IDMap contains a single entry for user namespace range remapping. An array of IDMap entries represents the structure that will be provided to the Linux kernel…
3 properties
HealthCheckResults
object
HealthCheckResults describes the results/logs from a healthcheck
3 properties
HealthCheckOnFailureAction
integer
HealthCheckOnFailureAction defines how Podman reacts when a container's health status turns unhealthy.
ContainerNetworkStats
object
Statistics for an individual container network interface
8 properties
BindOptions
object
5 properties
ImageOptions
object
1 property
PortMapping
object
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

podman-containers-api-openapi.yml Raw ↑

Other APIs Podman publishes across the network.

Podman artifacts API
Podman containers (compat) API
Podman exec API
Podman exec (compat) API
Podman images API
Podman images (compat) API
Podman manifests API
Podman networks API
Podman networks (compat) API
Podman pods API
Podman quadlets API
Podman secrets API
Where this information came from

This is an independent, third-party profile of Podman containers 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.