Review a Draft
Only the Slack user who created a draft can act on it. The service compares the interacting Slack user ID with created_by; another user receives an ownership error.
-
Approve changes a pending draft to approved and publishes it. A failed destination write returns it to pending approval for retry.
-
Edit opens a modal for title, summary, root cause, resolution steps, and tags. Submission updates the stored draft and posts a fresh preview. Editing does not publish.
-
Cancel changes the draft to cancelled and creates no PR or page.
Buttons require Slack Interactivity. Fallback commands are /knowledge approve <draft-id>, /knowledge edit <draft-id>, and /knowledge cancel <draft-id>. The edit slash command tells the user to use the preview button because a modal requires an interaction trigger. Completed or cancelled drafts cannot be edited, and status transitions prevent duplicate publication.