Skip to main content
GET
List Remediations
string
Filter by Kubernetes namespace (omit for all namespaces)
string
Filter by state (case-insensitive): Pending, WaitingApproval, Executing, Verifying, Completed, Failed, RolledBack
string
Filter by the name of the parent Issue (e.g., payment-service-oom-kill-1773933600)
integer
default:"1"
Page number for pagination
integer
default:"20"
Items per page (max 100)

Remediation Modes

Each plan operates in one of two modes:
  • Runbook mode (agenticMode: false): Executes a pre-defined sequence of actions from a matched runbook
  • Agentic mode (agenticMode: true): AI-driven step-by-step remediation where the LLM proposes actions, observes results, and decides next steps
Plans are named <issue>-plan-<attempt>. Empty optional fields (result, actions, startedAt, completedAt) are omitted.

Authorizations

X-API-Key
string
header
required

API key sent in the X-API-Key header. Keys are read from the Secret chatcli-operator-secrets, key api-keys (fallback: ConfigMap chatcli-operator-config, key api-keys) in the operator namespace, as a YAML list of {key, role, name, description} (name is the identity recorded on approval decisions); the operator chart creates it only with apiKeys.create: true. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds; deleting both the Secret and the ConfigMap revokes every key. With no keys configured every /api/ call returns 401, unless CHATCLI_OPERATOR_DEV_MODE=true, which grants admin without a key (development only).

Query Parameters

namespace
string

Kubernetes namespace. Empty means all namespaces.

state
enum<string>

Case-insensitive match on status.state.

Available options:
Pending,
WaitingApproval,
Executing,
Verifying,
Completed,
Failed,
RolledBack
issue
string

Exact match on spec.issueRef.name.

page
integer
default:1

Page number (1-based). Invalid values fall back to 1.

Required range: x >= 1
pageSize
integer
default:20

Items per page. Values above 100 are capped at 100.

Required range: 1 <= x <= 100

Response

Paginated list of remediation plans

apiVersion
string
Example:

"v1"

kind
string
Example:

"RemediationPlanList"

metadata
object
items
object[]