Skip to main content
POST
Reset post-mortem content

Restrictions

Usage

  • Requires the On-call Pro license.
  • The caller must be an account owner or admin, or a member of the report’s team; otherwise the call returns AccessDenied.
  • The report must be drafting and its current revision must equal expected_revision; otherwise the API returns 409 Conflict.
  • Reuse an idempotency_key only for the same report, revision, and Markdown content; different reuse returns 409 Conflict.
  • While another reset of the same report is still running, the call returns RequestTooFrequently; retry later.
  • A successful reset disconnects the previous collaboration (Yjs) room. Reconnect to the new generation room post-mortem-{accountId}-{postMortemId}-g{N} (generation 0 has no -g suffix). The reset cannot be rolled back.
  • Markdown content is limited to 4 MiB.
  • Every call is recorded in the account audit log. Don’t put secrets in request fields.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Body

application/json

Parameters for fully replacing a drafting post-mortem report body.

post_mortem_id
string
required

ID of the post-mortem to reset; obtain it from POST /incident/post-mortem/list.

markdown
string
required

Replacement Markdown content. Limited to 4 MiB.

expected_revision
integer<int64> | null
required

Current content revision expected by the caller. Pass 0 for the first write to a document that has never been saved.

Required range: x >= 0
idempotency_key
string
required

Non-blank key for safely retrying this exact reset request.

Required string length: 1 - 128

Response

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

Result of a successful full post-mortem content reset.