Skip to main content
POST
/
postmortems
/
{name}
/
review
Review Postmortem
curl --request POST \
  --url http://{host}:{port}/{basePath}/postmortems/{name}/review \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reviewer": "carlos.silva@empresa.com",
  "notes": "Root cause confirmed. Adding additional action item for rate limiting."
}
'
{
  "apiVersion": "v1",
  "kind": "PostMortem",
  "metadata": {
    "name": "PM-20260319-001",
    "namespace": "production"
  },
  "status": {
    "state": "InReview",
    "reviewer": "carlos.silva@empresa.com",
    "reviewStartedAt": "2026-03-19T17:00:00Z",
    "notes": "Root cause confirmed. Adding additional action item for rate limiting."
  }
}
name
string
required
Unique postmortem name (e.g., PM-20260319-001)
namespace
string
default:"default"
Kubernetes namespace
reviewer
string
Identifier of the reviewer (e.g., email or username)
notes
string
Review notes or corrections to the AI-generated postmortem

When to Use

PostMortems are auto-generated when an incident is resolved. This endpoint allows the team to:
  1. Mark it as under review — signals to the team that someone is reviewing the AI analysis
  2. Add corrections — override or supplement the AI-generated root cause, timeline, or action items
  3. Track review status — distinguish between unreviewed (auto-generated) and human-validated postmortems
{
  "apiVersion": "v1",
  "kind": "PostMortem",
  "metadata": {
    "name": "PM-20260319-001",
    "namespace": "production"
  },
  "status": {
    "state": "InReview",
    "reviewer": "carlos.silva@empresa.com",
    "reviewStartedAt": "2026-03-19T17:00:00Z",
    "notes": "Root cause confirmed. Adding additional action item for rate limiting."
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

name
string
required

Unique postmortem name.

Example:

"PM-20260319-001"

Query Parameters

namespace
string
default:default

Kubernetes namespace.

Body

application/json
reviewer
string

Reviewer identifier (e.g. email).

Example:

"carlos.silva@empresa.com"

notes
string

Review notes or corrections.

Example:

"Root cause confirmed. Adding additional action item for rate limiting."

Response

Postmortem moved to InReview

apiVersion
string
Example:

"v1"

kind
string
Example:

"PostMortem"

metadata
object
resourceMeta
object

Used by some endpoints in place of metadata.

report
object
status
object