Convert a work item to a follow-up
Convert an incident action item into a post-mortem follow-up in place.
Restrictions
Usage
- Requires the On-call Pro license.
- Converts an
actionitem into a post-mortemfollow_upin place — thework_item_iddoes not change. - Converting an item that is already a
follow_upreturnsidempotent_replay: true. - If a post-mortem already exists for the incident, the converted item auto-binds to it.
- Audited — changes are recorded in the audit log.
Authorizations
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
Parameters for converting an action item into a post-mortem follow-up in place.
Work item ID (opaque string, max 128 characters).
128Current item version for optimistic locking. Must match the stored version.
Client-generated idempotency key (max 128 characters; letters, digits, _, -, ., : only).
128^[A-Za-z0-9_\-.:]+$Optional client-defined status to set on the converted follow-up (max 64 characters).
64Response
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.