List post-mortems

List post-mortem reports with optional filters.

POST /incident/post-mortem/list

List post-mortems

cURL

curl --request POST \
  --url 'https://api.flashcat.cloud/incident/post-mortem/list?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "status": "published",
  "p": 1,
  "limit": 20
}
'

200

{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "total": 3,
    "has_next_page": false,
    "items": [
      {
        "account_id": 2451002751131,
        "title": "Postmortem1",
        "status": "published",
        "post_mortem_id": "8104935102bf89dc01ac638a5261fe7e",
        "template_id": "post_mortem_default_tmpl_en-us",
        "incident_ids": [
          "69bb9233331067560c718ecd"
        ],
        "media_count": 0,
        "author_ids": [
          2477273692131
        ],
        "team_id": 2477033058131,
        "channel_id": 3047621227131,
        "is_private": false,
        "channel_name": "Ops Channel",
        "created_at_seconds": 1773900354,
        "updated_at_seconds": 1773909012
      }
    ]
  }
}

Restrictions

Aspect	Value
Rate limits	1,000 requests/minute; 50 requests/second per account
Permissions	Incidents Read (on-call)

Authorizations

app_key · string · query · required

App key issued from the Flashduty console under Account → APP Keys. Required on every public API call. Keep it secret — it grants the same access as the owning account.

Body

application/json

Filters for the post-mortem report list.

status · enum<string>

Report status. Defaults to published on the server when omitted.

Available options: drafting, published

team_ids · integer<int64>[]

Team IDs to restrict the query to.

channel_ids · integer<int64>[]

Channel IDs to restrict the query to.

created_at_start_seconds · integer<int64>

Filter by creation time: lower bound in seconds.

Required range: x >= 0

created_at_end_seconds · integer<int64>

Filter by creation time: upper bound in seconds.

Required range: x >= 0

order_by · enum<string>

Field used to order results.

Available options: created_at_seconds, updated_at_seconds

asc · boolean

Ascending order when true.

p · integer<int64>

Page number starting at 1.

Required range: x >= 0

limit · integer<int64> · default: 20

Page size, at most 100.

Required range: 0 <= x <= 100

search_after_ctx · string

Cursor from a previous response for forward pagination.

Response

200

application/json

Success

Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.

request_id · string · required

Unique ID for this request. Mirrored in the Flashcat-Request-Id response header. Include it when reporting issues.

Example:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data · object · required

Paginated list of post-mortem reports.

Show child attributes