Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.kguardian.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
POST /pods

Add or update pod metadata.

​
Request

{
  "pod_ip": "10.244.1.5",
  "pod_name": "my-app-7d9f6b8c4-x5z2w",
  "pod_namespace": "production"
}

​
Response

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "pod_ip": "10.244.1.5",
  "pod_name": "my-app-7d9f6b8c4-x5z2w",
  "pod_namespace": "production"
}

​
POST /pod/spec

Add full pod specification including labels and metadata.

​
Request

{
  "pod_ip": "10.244.1.5",
  "pod_name": "my-app",
  "pod_namespace": "production",
  "pod_obj": {
    "metadata": {
      "labels": {
        "app": "my-app",
        "version": "v1.0.0"
      }
    },
    "spec": { /* full pod spec */ }
  }
}

​
GET /pod/ip/:ip

Retrieve pod details by IP address.

​
Example

curl http://localhost:9090/pod/ip/10.244.1.5

​
Response

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "pod_ip": "10.244.1.5",
  "pod_name": "my-app",
  "pod_namespace": "production",
  "pod_obj": { /* full pod spec */ }
}