On-Call API › Postmortems
Get an incident's postmortem
GET/api/v1/incidents/{id}/postmortem
Returns the incident's postmortem. An incident without one yet answers 200
with data: null.
Permission (API-key scope): oncall:postmortem:read.
Authorization
bearerAuth(oncall:postmortem:read)apiKeyHeader(oncall:postmortem:read)
Parameters
Path parameters
idstring requiredThe incident's id.
Responses
200
The postmortem, or null.
dataPostmortem | null required- Postmortem
Show Postmortem properties
idstringorg_idstringincident_idstringauthor_idstringstatusPostmortemStatussummarystringroot_causestringcontributing_factorsstringtimelinestringaction_itemsstringlessons_learnedstringpublished_atstring (date-time)created_atstring (date-time)updated_atstring (date-time)
- null
successboolean required
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
403
The key lacks the scope this endpoint needs (FORBIDDEN).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
404
No incident with this id in your organization (NOT_FOUND).
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
429
Too many requests (RATE_LIMITED). Wait Retry-After seconds.
Retry-AfterintegerSeconds to wait.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
errorobject requiredcodestring requiredMachine-readable code. Branch on this.messagestring requiredHuman-readable explanation.
Example request
curl -X GET 'https://evohub.io/api/v1/incidents/2e7f9a1b-3c4d-4e5f-8a9b-0c1d2e3f4a5b/postmortem' \
-H 'Authorization: Bearer <TOKEN>'