Skip to main content
POST
Postmortem Feedback
string
required
PostMortem name (e.g., pm-checkout-service-oom-kill-1773871200)
string
default:"default"
Kubernetes namespace (only default is searched when omitted)
string
required
Identifier of who is providing feedback (e.g., email or username). Maximum 253 characters.
integer
required
Rating from 1 to 5 for the AI’s automatic remediation accuracy
  • 1 — Completely wrong, did not resolve anything
  • 2 — Partially correct, but with significant issues
  • 3 — Reasonable, resolved but required manual adjustments
  • 4 — Good, resolved with minor observations
  • 5 — Excellent, perfect remediation
string
Human-provided root cause, stored in feedback.overrideRootCause next to the AI analysis (the AI rootCause field itself is not rewritten). Maximum 4096 characters.
string
Additional comments about the postmortem or remediation. Maximum 4096 characters.

When to Use

After reviewing a postmortem in the Dashboard, the developer can provide structured feedback:
  1. Rate the remediation: score from 1 to 5 the accuracy of the automated action
  2. Correct root cause: record the right root cause if the AI was wrong or imprecise
  3. Add context: comments with information the AI did not have access to
Feedback is displayed directly in the Dashboard and persisted in the PostMortem CR status.
Requires operator role or higher. The providedBy field is mandatory for traceability. remediationAccuracy must be 1 to 5 (0 or a missing value returns 400). Submitting feedback again overwrites the previous feedback. On concurrent modification, the API returns 409 Conflict.

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).

Path Parameters

name
string
required

PostMortem name.

Example:

"pm-payment-service-oom-1710860400"

Query Parameters

namespace
string
default:default

Namespace of the object. Defaults to default — pass it for objects in any other namespace.

Body

application/json
providedBy
string
required

Identifier of the feedback author.

Maximum string length: 253
Example:

"sre-oncall"

remediationAccuracy
integer
required

Score 1-5 for the AI remediation accuracy.

Required range: 1 <= x <= 5
Example:

4

overrideRootCause
string

Human-provided root cause overriding the AI analysis.

Maximum string length: 4096
comments
string

Additional comments.

Maximum string length: 4096

Response

Feedback recorded

apiVersion
string
Example:

"v1"

kind
string
Example:

"PostMortem"

spec
object
status
object
resourceMeta
object