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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kubernetes

Kubernetes Workloads API

Workload resources including Pods, Deployments, StatefulSets, DaemonSets, ReplicaSets, Jobs, and CronJobs for managing containerized applications.

Documentation Provider Profile APIs.io OpenAPI GitHub

Kubernetes Workloads API is one of 7 APIs that Kubernetes publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Workloads. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, an AsyncAPI specification, and 1 JSON Schema.

This API exposes 13 operations across 6 paths, and defines 22 schemas. It is described by OpenAPI 3.2.0, at version v1.32.0.

Requests are made against a single base URL, https://kubernetes.default.svc.

13 operations 6 paths 22 schemas 2 DELETE6 GET2 POST3 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v1.32.0
Base URL
https://kubernetes.default.svc
Authentication
HTTP Bearer, Mutual TLS
Contact
Kubernetes Community
Terms of Service
View terms
Resource Areas
1

Authentication & Security 2

Kubernetes Workloads API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). It requires mutual TLS (clientCertificate). By default, every request must be authenticated.

  • bearerAuth — Kubernetes service account token or user token issued by the cluster's authentication provider. Include in the Authorization header as 'Bearer '.
  • clientCertificate — Client certificate authentication using a TLS certificate issued by the cluster's certificate authority.

Paths & Operations 13

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

Workloads 13

Workload resources including Pods, Deployments, StatefulSets, DaemonSets, ReplicaSets, Jobs, and CronJobs for managing containerized applications.

GET
/api/v1/namespaces/{namespace}/pods
Kubernetes List pods in a namespace
listNamespacedPods 7 params → 200401
POST
/api/v1/namespaces/{namespace}/pods
Kubernetes Create a pod
createNamespacedPod 1 param body → 201400401
GET
/api/v1/namespaces/{namespace}/pods/{name}
Kubernetes Get a pod
getNamespacedPod 2 params → 200401404
PUT
/api/v1/namespaces/{namespace}/pods/{name}
Kubernetes Replace a pod
replaceNamespacedPod 2 params body → 200401404
DELETE
/api/v1/namespaces/{namespace}/pods/{name}
Kubernetes Delete a pod
deleteNamespacedPod 3 params → 200401404
GET
/api/v1/namespaces/{namespace}/pods/{name}/log
Kubernetes Read pod logs
readNamespacedPodLog 6 params → 200401404
GET
/apis/apps/v1/namespaces/{namespace}/deployments
Kubernetes List deployments in a namespace
listNamespacedDeployments 5 params → 200401
POST
/apis/apps/v1/namespaces/{namespace}/deployments
Kubernetes Create a deployment
createNamespacedDeployment 1 param body → 201400401
GET
/apis/apps/v1/namespaces/{namespace}/deployments/{name}
Kubernetes Get a deployment
getNamespacedDeployment 2 params → 200401404
PUT
/apis/apps/v1/namespaces/{namespace}/deployments/{name}
Kubernetes Replace a deployment
replaceNamespacedDeployment 2 params body → 200401404
DELETE
/apis/apps/v1/namespaces/{namespace}/deployments/{name}
Kubernetes Delete a deployment
deleteNamespacedDeployment 2 params → 200401404
GET
/apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale
Kubernetes Get deployment scale
getNamespacedDeploymentScale 2 params → 200401404
PUT
/apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale
Kubernetes Scale a deployment
replaceNamespacedDeploymentScale 2 params body → 200401404

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are ObjectMeta (10 properties), Container (8 properties), PodSpec (7 properties), Status (6 properties). Each schema is shown below with its type and property counts.

DeploymentStrategy
object
Strategy for replacing existing pods with new ones during an update. Supports RollingUpdate (default) and Recreate strategies.
2 properties
EnvVar
object
An environment variable to set in a container.
2 properties 1 required
PodTemplateSpec
object
Template for creating pod replicas. Contains pod metadata (labels, annotations) and a pod spec.
2 properties
ListMeta
object
Metadata that all list responses include, containing pagination state and the resource version of the list.
3 properties
DeploymentSpec
object
Specification for a Deployment, defining the desired state including replica count, pod template, and update strategy.
6 properties 2 required
PodStatus
object
Most recently observed status of the pod. This data may not be up-to-date and is populated by the system.
5 properties
PodCondition
object
Condition representing the current state of a pod component.
4 properties 2 required
LabelSelector
object
A label selector is a query over a set of resources. matchLabels specifies key-value pairs that must match, while matchExpressions supports set-based criteria.
2 properties
PodSpec
object
Specification for the desired behavior of a pod, including the containers to run, volumes to mount, scheduling constraints, and restart policy.
7 properties 1 required
LabelSelectorRequirement
object
A requirement that uses set-based operators to match labels.
3 properties 2 required
DeploymentStatus
object
Most recently observed status of a Deployment including replica counts and rollout conditions.
5 properties
Scale
object
Scale represents the scaling subresource of a workload resource. Used to read and update the replica count independently of the full resource spec.
5 properties
ResourceRequirements
object
Compute resource requirements for a container, specifying resource limits and requests for CPU and memory.
2 properties
Container
object
A single container to run within a pod. Defines the container image, command, environment, resource requirements, ports, and volume mounts.
8 properties 2 required
ContainerPort
object
A network port that a container exposes. Used for documentation and for service discovery via protocol and port number.
4 properties 1 required
PodList
object
A list of pods returned by list operations.
4 properties 1 required
ObjectMeta
object
Standard Kubernetes object metadata included on all persistent resources. Contains identifying information, ownership references, and system-managed fields lik…
10 properties
DeploymentList
object
A list of deployments returned by list operations.
4 properties 1 required
OwnerReference
object
Reference to an owning resource that manages this object's lifecycle via garbage collection.
5 properties 4 required
Status
object
Status is a return value for calls that don't return other objects. It is used to convey error messages, reasons, and codes for both success and failure respon…
6 properties
Pod
object
A Pod represents the smallest deployable unit in Kubernetes, encapsulating one or more containers with shared storage and network. Pods are ephemeral by nature…
5 properties
Deployment
object
A Deployment provides declarative updates for Pods and ReplicaSets. You describe a desired state in a Deployment and the controller changes the actual state to…
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kubernetes-workloads-api-openapi.yml Raw ↑

Other APIs Kubernetes publishes across the network.

Kubernetes Autoscaling API
AE Profile APIs.io
Kubernetes Cluster API
AE Profile APIs.io
Kubernetes Config API
AE Profile APIs.io
Kubernetes Events API
AE Profile APIs.io
Kubernetes Namespaces API
AE Profile APIs.io
Kubernetes RBAC API
AE Profile APIs.io
#Workloads
← Back to K APIs
API Details
ID
kubernetes:kubernetes-workloads-api
Base URL
https://kubernetes.default.svc
Docs
https://kubernetes.io/docs/concepts/overview/kubernetes-api/
Provider
Kubernetes
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=kubernetes-workloads-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/kubernetes-workloads-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

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

Where this information came from

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