API Reference

Podex exposes a local HTTP REST and WebSocket API from the backend daemon (default port: 8000).

REST Endpoints

Cluster Statistics

GET /api/stats

Returns total node count, pod count, deployment count, service count, and namespace status.

Resource Discovery

GET /api/pods?namespace=<ns>&show_system=<bool>
GET /api/deployments
GET /api/services

Returns lists of resources with metadata, state, and configuration.

Debugging & Details

GET /api/pods/{namespace}/{name}/details
GET /api/pods/{namespace}/{name}/logs

Workload Operations

POST /api/deployments/{namespace}/{name}/restart
POST /api/deployments/{namespace}/{name}/scale?replicas=<n>
DELETE /api/resources/{namespace}/{name}?type=<pod|deployment|service>
POST /api/apply-yaml

AI Integration

POST /api/investigate
  Body: { namespace, pod_name, container_name }
  Returns: Diagnosis report with root cause, evidence, and fix

POST /api/learn
  Body: { concept }
  Returns: Explanation with analogies and gotchas

WebSocket Endpoints

Interactive Terminal Shell

WS /api/ws/terminal/{namespace}/{pod_name}/{container_name}

Binds browser terminal inputs directly to /bin/sh or /bin/bash processes in the container.