Podman

Podman Pods API

Actions related to pods

GitHub OpenAPI

Operations 19

GET /libpod/generate/{name}/systemd Generate Systemd Units #
GET /libpod/generate/kube Generate a Kubernetes YAML file #
POST /libpod/kube/apply Apply a podman workload or Kubernetes YAML file #
DELETE /libpod/play/kube Remove resources created from kube play #
POST /libpod/play/kube Play a Kubernetes YAML file #
DELETE /libpod/pods/{name} Remove pod #
GET /libpod/pods/{name}/exists Pod exists #
GET /libpod/pods/{name}/json Inspect pod #
POST /libpod/pods/{name}/kill Kill a pod #
POST /libpod/pods/{name}/pause Pause a pod #
POST /libpod/pods/{name}/restart Restart a pod #
POST /libpod/pods/{name}/start Start a pod #
POST /libpod/pods/{name}/stop Stop a pod #
GET /libpod/pods/{name}/top List processes #
POST /libpod/pods/{name}/unpause Unpause a pod #
POST /libpod/pods/create Create a pod #
GET /libpod/pods/json List pods #
POST /libpod/pods/prune Prune unused pods #
GET /libpod/pods/stats Statistics for one or more pods #

Documentation

📖
Documentation
https://docs.podman.io/en/latest/_static/api.html
📖
GettingStarted
https://docs.podman.io/en/latest/markdown/podman-system-service.1.html

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/podman/refs/heads/main/openapi/podman-pods-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/podman-pods-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

podman-pods-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: podman@lists.podman.io
    name: Podman
    url: https://podman.io/community/
  description: This documentation describes the Podman v2.x+ RESTful API.
  license:
    name: Apache-2.0
    url: https://opensource.org/licenses/Apache-2.0
  termsOfService: https://github.com/containers/podman/blob/913caaa9b1de2b63692c9bae15120208194c9eb3/LICENSE
  title: supports a RESTful API for the Libpod library Pods API
  version: 5.0.0
  x-logo:
  - url: https://raw.githubusercontent.com/containers/libpod/main/logo/podman-logo.png
  - altText: Podman logo
servers:
- url: http://podman.io/
- url: https://podman.io/
tags:


# --- truncated at 32 KB (88 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/podman/refs/heads/main/openapi/podman-pods-api-openapi.yml