Skip to main content
POST
Acknowledge required human action
string
required
PostMortem name (e.g., pm-checkout-service-oom-kill-1773871200)
string
default:"default"
Kubernetes namespace (only default is searched when omitted)
string
Who performed the follow-up. Maximum 253 characters. Stored in the annotation aiops.chatcli.io/human-action-acknowledged-by.
string
Free-text note about what was done. Maximum 1024 characters. Stored in the annotation aiops.chatcli.io/human-action-note.

When to Use

When the operator contains an incident (for example, it silences a crashing workload instead of fixing it), the Issue ends in state Contained and its PostMortem gets requiresHumanAction: true plus a requiredAction describing what a person must do. While that flag is set and not acknowledged, the PostMortem controller reverts any Closed state back to Open. After doing the follow-up, call this endpoint. It:
  1. Sets the annotations aiops.chatcli.io/human-action-acknowledged: "true" and aiops.chatcli.io/human-action-acknowledged-at (UTC, RFC 3339), plus -acknowledged-by and human-action-note when sent
  2. Clears status.requiresHumanAction (requiredAction is kept as history)
Then close the postmortem. The body is optional. Minimum role: operator.
The call does not restore the workload itself; it only records that someone did. Setting the annotation with kubectl annotate has the same effect on the controller (values true, True, yes, ack and acknowledged are accepted), but leaves status.requiresHumanAction set.

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, description}; no chart creates it. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds. 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
acknowledgedBy
string

Who performed the required action.

Maximum string length: 253
Example:

"sre-team"

note
string

Free-text note describing the action taken.

Maximum string length: 1024
Example:

"Rolled back to v1.2.3 and scaled replicas back to 3."

Response

Human action acknowledged. The response has spec and status but no resourceMeta.

apiVersion
string
Example:

"v1"

kind
string
Example:

"PostMortem"

spec
object
status
object
resourceMeta
object