Operations pillar · v0.16.0
incident Incident
Operational incident.
$id · https://corpospec.com/schemas/v0.16.0/incident.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| affected_customers | integer | yes | Affected customer count (best estimate). |
| affected_services | PathRef[] | yes | PathRefs to affected services. |
| corrective_actions | CorrectiveAction[] | yes | |
| created_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| customer_facing | boolean | yes | Whether customers were directly impacted. |
| detected_at | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| incident_commander | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| kind | OpIncidentKind | yes | Incident kind. |
| severity | OpIncidentSeverity | yes | Incident severity. |
| sla_credit_triggered | boolean | yes | Whether SLA credit was triggered (cross-link to service_level_agreement.rs). |
| status | OpIncidentStatus | yes | Lifecycle. |
| status_page_updated | boolean | yes | Whether a status-page update was published. |
| summary | string | yes | |
| timeline | IncidentTimeline[] | yes | |
| title | string | yes | |
| contributing_factors | string[] | — | Contributing factors (non-blameless framing). |
| impact_started_at | IsoDate? | — | When users first felt impact (may pre-date detection). |
| mitigated_at | IsoDate? | — | |
| postmortem_ref | PathRef? | — | PathRef to the postmortem document. |
| resolved_at | IsoDate? | — | |
| root_cause | string? | — | Root-cause narrative. |
| runbook_refs | PathRef[] | — | PathRefs to runbooks used. |
| sla_credit_pct | number? | — | |
| status_page_ref | PathRef? | — | PathRef to status-page artefact. |
Definitions
Shared types referenced within this schema.
CorrectiveAction
Corrective-action item.
type: object
IncidentTimeline
One timeline entry.
type: object
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
OpIncidentKind
Incident kind.
OpIncidentSeverity
Incident severity.
OpIncidentStatus
Lifecycle.
enum: "detected", "investigating", "mitigating", "resolved", "postmortem", "closed"
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/incident.schema.json