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

Actions related to images

Podman images API is one of 18 APIs that Podman 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 23 operations across 23 paths, and defines 20 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/.

23 operations 23 paths 20 schemas 2 DELETE10 GET11 POST

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 23

Across 23 paths, the API surfaces 23 operations — 2 DELETE, 10 GET, 11 POST. Each is listed below with its method, path, parameters, and response codes.

images 23

Actions related to images

POST
/libpod/build
Build image
ImageBuildLibpod 44 params → 200400500
DELETE
/libpod/images/{name}
Remove an image from the local storage.
ImageDeleteLibpod 4 params → 200400404409500
GET
/libpod/images/{name}/changes
Report on changes to images's filesystem; adds, deletes or modifications.
ImageChangesLibpod 3 params → 200404500
GET
/libpod/images/{name}/exists
Image exists
ImageExistsLibpod 1 param → 204404500
GET
/libpod/images/{name}/get
Export an image
ImageGetLibpod 3 params → 200404500
GET
/libpod/images/{name}/history
History of an image
ImageHistoryLibpod 1 param → 200404500
GET
/libpod/images/{name}/json
Inspect an image
ImageInspectLibpod 1 param → 200404500
POST
/libpod/images/{name}/push
Push Image
ImagePushLibpod 13 params → 200404500
GET
/libpod/images/{name}/resolve
Resolve an image (short) name
ImageResolveLibpod 1 param → 204400500
POST
/libpod/images/{name}/tag
Tag an image
ImageTagLibpod 3 params → 201400404409500
GET
/libpod/images/{name}/tree
Image tree
ImageTreeLibpod 2 params → 200404500
POST
/libpod/images/{name}/untag
Untag an image
ImageUntagLibpod 3 params → 201400404409500
GET
/libpod/images/export
Export multiple images
ImageExportLibpod 4 params → 200404500
POST
/libpod/images/import
Import image
ImageImportLibpod 5 params body → 200400500
GET
/libpod/images/json
List Images
ImageListLibpod 2 params → 200500
POST
/libpod/images/load
Load image
ImageLoadLibpod body → 200400500
POST
/libpod/images/prune
Prune unused images
ImagePruneLibpod 4 params → 200500
POST
/libpod/images/pull
Pull images
ImagePullLibpod 11 params → 200400500default
DELETE
/libpod/images/remove
Remove one or more images from the storage.
ImageDeleteAllLibpod 5 params → 200400500
POST
/libpod/images/scp/{name}
Copy an image from one host to another
ImageScpLibpod 3 params → 200400500
GET
/libpod/images/search
Search images
ImageSearchLibpod 5 params → 200500
POST
/libpod/local/build
Create image from local build context
LocalBuildLibpod 44 params → 200400404500
POST
/libpod/local/images/load
Load image from local path
LocalImagesLibpod 1 param → 200400404500

Schemas 20

The contract defines 20 schemas that model the data the API accepts and returns. The most detailed are ImageData (23 properties), ImageConfig (10 properties), HistoryResponse (6 properties), Schema2HealthConfig (6 properties). Each schema is shown below with its type and property counts.

Digest
string
The following is an example of the contents of Digest types: sha256:7173b809ca12ec5dee4506cd86be934c4596dd234ee82c0662eac04a8c2c71dc This allows to abstract th…
LibpodImagesPullReport
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…
LibpodImagesRemoveReport
LibpodImagesRemoveReport is the return type for image removal via the rest api.
Schema2HealthConfig
object
Schema2HealthConfig is a HealthConfig, which holds configuration settings for the HEALTHCHECK feature, from docker/docker/api/types/container.
6 properties
ImageRemoveReport
object
ImageRemoveReport is the response for removing one or more image(s) from storage and images what was untagged vs actually removed.
ImageLoadReport
object
ImageConfig
object
10 properties
PruneReport
object
POST "/volumes/prune"
3 properties
DriverData
object
DriverData handles the data for a storage driver
2 properties 2 required
ImageImportReport
object
HistoryResponse
object
HistoryResponse provides details on image layers
6 properties
ErrorModel
object
ErrorModel is used in remote connections with podman
3 properties
ImagePullReport
object
History
object
5 properties
ScpReport
object
1 property
RootFS
object
2 properties
ImageTreeReport
object
ImageTreeReport provides results from ImageEngine.Tree()
ImageData
object
23 properties
ImageSummary
object

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

podman-images-api-openapi.yml Raw ↑

Other APIs Podman publishes across the network.

Podman artifacts API
Podman containers API
Podman containers (compat) API
Podman exec API
Podman exec (compat) 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 images 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.