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

Cluster-level resources including Namespaces, Nodes, ServiceAccounts, and RBAC resources for cluster administration.

Documentation Provider Profile APIs.io OpenAPI GitHub

Kubernetes Cluster 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 Cluster. 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 7 operations across 4 paths, and defines 12 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.

7 operations 4 paths 12 schemas 1 DELETE4 GET1 POST1 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 Cluster 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 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Cluster 7

Cluster-level resources including Namespaces, Nodes, ServiceAccounts, and RBAC resources for cluster administration.

GET
/api/v1/namespaces
Kubernetes List namespaces
listNamespaces 6 params → 200401
POST
/api/v1/namespaces
Kubernetes Create a namespace
createNamespace body → 201400401409
GET
/api/v1/namespaces/{name}
Kubernetes Get a namespace
getNamespace 1 param → 200401404
PUT
/api/v1/namespaces/{name}
Kubernetes Replace a namespace
replaceNamespace 1 param body → 200401404
DELETE
/api/v1/namespaces/{name}
Kubernetes Delete a namespace
deleteNamespace 1 param → 200401404
GET
/api/v1/nodes
Kubernetes List nodes
listNodes 4 params → 200401
GET
/api/v1/nodes/{name}
Kubernetes Get a node
getNode 1 param → 200401404

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are ObjectMeta (10 properties), Status (6 properties), Node (5 properties), Namespace (5 properties). Each schema is shown below with its type and property counts.

ListMeta
object
Metadata that all list responses include, containing pagination state and the resource version of the list.
3 properties
Node
object
A Node is a worker machine in Kubernetes. Each node contains the services necessary to run pods and is managed by the control plane. Nodes have resources inclu…
5 properties
NodeSpec
object
Specification of a node, including taints and configuration sources.
4 properties
NodeList
object
A list of nodes returned by list operations.
4 properties 1 required
Namespace
object
A Namespace provides a mechanism for isolating groups of resources within a single cluster. Names of resources need to be unique within a namespace, but not ac…
5 properties
NamespaceList
object
A list of namespaces returned by list operations.
4 properties 1 required
NodeCondition
object
Condition describing the current state of a node component.
4 properties 2 required
ObjectMeta
object
Standard Kubernetes object metadata included on all persistent resources. Contains identifying information, ownership references, and system-managed fields lik…
10 properties
OwnerReference
object
Reference to an owning resource that manages this object's lifecycle via garbage collection.
5 properties 4 required
Taint
object
A taint applied to a node that repels pods without a matching toleration. Used for dedicated nodes, nodes with special hardware, or node evictions.
3 properties 2 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
NodeStatus
object
Most recently observed status of the node including capacity, allocatable resources, conditions, and system info.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kubernetes-cluster-api-openapi.yml Raw ↑

Other APIs Kubernetes publishes across the network.

Kubernetes Autoscaling 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
Kubernetes Workloads API
AE Profile APIs.io
#Cluster
← Back to K APIs
API Details
ID
kubernetes:kubernetes-cluster-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-cluster-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/kubernetes-cluster-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 Cluster 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.