Infrastructure Bearer Token

Kubernetes REST API

Container orchestration REST API for cloud-native apps

Kubernetes provides a comprehensive REST API for managing containerized applications at scale. Developers use it to automate deployment, scaling, and operations of application containers across clusters of hosts. The API enables programmatic control over pods, services, deployments, and cluster resources for building cloud-native infrastructure.

Base URL https://kubernetes-cluster.example.com/api/v1

API Endpoints

Method	Endpoint	Description
GET	`/namespaces/{namespace}/pods`	List all pods in a specific namespace
POST	`/namespaces/{namespace}/pods`	Create a new pod in the specified namespace
GET	`/namespaces/{namespace}/pods/{name}`	Get details of a specific pod by name
DELETE	`/namespaces/{namespace}/pods/{name}`	Delete a specific pod from the cluster
GET	`/namespaces/{namespace}/services`	List all services in a namespace
POST	`/namespaces/{namespace}/services`	Create a new service to expose pods
GET	`/namespaces/{namespace}/deployments`	List all deployments in a namespace
POST	`/namespaces/{namespace}/deployments`	Create a new deployment for application rollout
PATCH	`/namespaces/{namespace}/deployments/{name}`	Update an existing deployment configuration
GET	`/nodes`	List all nodes in the Kubernetes cluster
GET	`/nodes/{name}`	Get details of a specific cluster node
GET	`/namespaces/{namespace}/configmaps`	List all ConfigMaps for storing configuration data
GET	`/namespaces/{namespace}/secrets`	List all Secrets for storing sensitive information
GET	`/namespaces/{namespace}/persistentvolumeclaims`	List all persistent volume claims for storage
GET	`/namespaces/{namespace}/pods/{name}/log`	Retrieve logs from a specific pod container

Code Examples

curl -X GET https://kubernetes-cluster.example.com/api/v1/namespaces/default/pods \
  -H 'Authorization: Bearer eyJhbGciOiJSUzI1NiIsImtpZCI6IkRHV...' \
  -H 'Accept: application/json'

const token = 'eyJhbGciOiJSUzI1NiIsImtpZCI6IkRHV...';
const baseUrl = 'https://kubernetes-cluster.example.com/api/v1';

fetch(`${baseUrl}/namespaces/default/pods`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Accept': 'application/json'
  }
})
.then(response => response.json())
.then(data => {
  console.log('Pods:', data.items);
})
.catch(error => console.error('Error:', error));

import requests

token = 'eyJhbGciOiJSUzI1NiIsImtpZCI6IkRHV...'
base_url = 'https://kubernetes-cluster.example.com/api/v1'

headers = {
    'Authorization': f'Bearer {token}',
    'Accept': 'application/json'
}

response = requests.get(
    f'{base_url}/namespaces/default/pods',
    headers=headers
)

if response.status_code == 200:
    pods = response.json()['items']
    for pod in pods:
        print(f"Pod: {pod['metadata']['name']}")
else:
    print(f"Error: {response.status_code}")

Use Kubernetes from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Kubernetes. Paste your Kubernetes API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Kubernetes directly with your credentials — no local install, works on mobile.

list_pods List all pods across namespaces with filtering by labels and status

create_deployment Create a new deployment from a container image with replica count and resource limits

scale_deployment Scale a deployment up or down by adjusting replica count

get_pod_logs Retrieve and stream logs from specific pod containers for debugging

apply_manifest Apply YAML/JSON manifest to create or update Kubernetes resources

Connect in 60 seconds

Paste your Kubernetes key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Kubernetes to your AI →

Kubernetes REST API

API Endpoints

Sponsor this page

Code Examples

Use Kubernetes from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs