Skip to main content
GET
/
remediations
List Remediations
curl --request GET \
  --url http://{host}:{port}/{basePath}/remediations \
  --header 'Authorization: <api-key>'
{
  "apiVersion": "v1",
  "kind": "RemediationPlanList",
  "metadata": {
    "totalCount": 3,
    "page": 1,
    "pageSize": 20
  },
  "items": [
    {
      "name": "remediation-inc-20260319-001-1",
      "namespace": "production",
      "issueRef": "INC-20260319-001",
      "attempt": 1,
      "strategy": "Runbook: oomkill-standard (Tier 1 match: oom_kill + critical + Deployment)",
      "state": "Completed",
      "startedAt": "2026-03-19T14:35:00Z",
      "completedAt": "2026-03-19T14:38:00Z",
      "result": "All actions completed successfully. Resource healthy after verification.",
      "agenticMode": false,
      "agenticStepCount": 0,
      "actions": [
        {"type": "AdjustResources", "params": {"memoryLimit": "1Gi"}},
        {"type": "RestartDeployment", "params": {"deployment": "payment-service"}}
      ],
      "creationTimestamp": "2026-03-19T14:34:00Z"
    },
    {
      "name": "remediation-inc-20260319-002-1",
      "namespace": "production",
      "issueRef": "INC-20260319-002",
      "attempt": 1,
      "strategy": "Agentic mode: no matching runbook found",
      "state": "Executing",
      "startedAt": "2026-03-19T15:10:00Z",
      "result": "",
      "agenticMode": true,
      "agenticStepCount": 3,
      "actions": [],
      "creationTimestamp": "2026-03-19T15:09:00Z"
    }
  ]
}
​
namespace
string
Filter by Kubernetes namespace
​
state
string
Filter by state: Pending, Executing, Verifying, Completed, Failed, RolledBack
​
issue
string
Filter by incident name (e.g., INC-20260319-001)
​
page
integer
default:"1"
Page number for pagination
​
pageSize
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
{
  "apiVersion": "v1",
  "kind": "RemediationPlanList",
  "metadata": {
    "totalCount": 3,
    "page": 1,
    "pageSize": 20
  },
  "items": [
    {
      "name": "remediation-inc-20260319-001-1",
      "namespace": "production",
      "issueRef": "INC-20260319-001",
      "attempt": 1,
      "strategy": "Runbook: oomkill-standard (Tier 1 match: oom_kill + critical + Deployment)",
      "state": "Completed",
      "startedAt": "2026-03-19T14:35:00Z",
      "completedAt": "2026-03-19T14:38:00Z",
      "result": "All actions completed successfully. Resource healthy after verification.",
      "agenticMode": false,
      "agenticStepCount": 0,
      "actions": [
        {"type": "AdjustResources", "params": {"memoryLimit": "1Gi"}},
        {"type": "RestartDeployment", "params": {"deployment": "payment-service"}}
      ],
      "creationTimestamp": "2026-03-19T14:34:00Z"
    },
    {
      "name": "remediation-inc-20260319-002-1",
      "namespace": "production",
      "issueRef": "INC-20260319-002",
      "attempt": 1,
      "strategy": "Agentic mode: no matching runbook found",
      "state": "Executing",
      "startedAt": "2026-03-19T15:10:00Z",
      "result": "",
      "agenticMode": true,
      "agenticStepCount": 3,
      "actions": [],
      "creationTimestamp": "2026-03-19T15:09:00Z"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token issued by the operator. Format: Authorization: Bearer <token>.

Query Parameters

​
namespace
string

Filter by Kubernetes namespace.

​
state
enum<string>

Filter by execution state.

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

Filter by incident name.

​
page
integer
default:1

Page number.

​
pageSize
integer
default:20

Items per page (max 100).

Required range: x <= 100

Response

Paginated list of remediation plans

​
apiVersion
string
Example:

"v1"

​
kind
string
Example:

"RemediationPlanList"

​
metadata
object
​
items
object[]