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}")

Connect Kubernetes to AI

Deploy a Kubernetes MCP server on IOX Cloud and connect it to Claude, ChatGPT, Cursor, or any AI client. Your AI assistant gets direct access to Kubernetes through these tools:

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

Deploy in 60 seconds

Describe what you need, AI generates the code, and IOX deploys it globally.

Deploy Kubernetes MCP Server →

Kubernetes REST API

API Endpoints

Code Examples

Connect Kubernetes to AI

Deploy in 60 seconds

Related APIs