Skip to content

Get retrospective

GET
/api/v1/incidents/{incident_id}/retrospective

Returns post-incident retrospective report.

Authorizations

Parameters

Path Parameters

incident_id
required
string

Query Parameters

tenant_id
required

Tenant identifier

string

Tenant identifier

Responses

200

Successful Response

Post-incident retrospective report.

Args: incident_id: The incident this retrospective covers. title: Retrospective title. summary: Executive summary of the incident. timeline: Chronological incident timeline. root_cause: Root cause analysis (template/placeholder). impact: Impact assessment with metrics. what_went_well: List of positive outcomes. what_went_wrong: List of issues encountered. action_items: Follow-up tasks with assignees. generated_at: ISO timestamp of generation.

object
action_items
Array<object>

A post-incident action item.

Args: description: What needs to be done. assignee: Who is responsible (None if unassigned). status: Current status (open, in_progress, done). due_date: Target completion date (ISO, None if unset).

object
assignee
Any of:
string
description
string
""
due_date
Any of:
string
status
string
default: open
generated_at
string
impact

Impact assessment for a post-incident review.

Args: tenants_affected: Number of tenants impacted, or None for a platform-wide (“system”) incident that affects all tenants. None is used rather than a fabricated count because an exact active-tenant count requires a tenant repository not available to this generator. duration_seconds: Total incident duration. sla_impact: Whether SLA was breached. error_count: Total errors during the incident.

object
duration_seconds
integer
error_count
integer
sla_impact
boolean
tenants_affected
Any of:
integer
incident_id
string
""
root_cause
string
""
summary
string
""
timeline

Chronological timeline of events during an incident.

Args: incident_id: The incident this timeline belongs to. entries: List of timeline entries sorted by timestamp. window_start: Start of the incident window (ISO). window_end: End of the incident window (ISO).

object
entries
Array<object>

A single entry in an incident timeline.

Args: timestamp: ISO timestamp of the event. source: Event source (error_tracker, metrics, health, runbook, escalation). description: Human-readable event description. severity: Severity level of the event. data: Optional additional structured data.

object
data
Any of:
object
key
additional properties
any
description
string
""
severity
string
default: info
source
string
""
timestamp
string
incident_id
string
""
window_end
string
""
window_start
string
""
title
string
""
what_went_well
Array<string>
what_went_wrong
Array<string>

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string