Incident Resolved to Confluence Postmortem

arazzo: 1.0.1
info:
  title: Incident Resolved to Confluence Postmortem
  summary: Resolve a ServiceNow incident, publish a Confluence postmortem, then notify Slack.
  description: >-
    A cross-provider ITSM workflow that closes out a ServiceNow incident, publishes
    a postmortem page in Confluence capturing the resolution and lessons learned,
    and notifies the team in Slack that the writeup is available. Demonstrates
    orchestrating an enterprise ITSM platform, a knowledge base, and a team
    messaging provider across incident closure in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: servicenowTable
    url: https://raw.githubusercontent.com/api-evangelist/servicenow/refs/heads/main/openapi/servicenow-table-api-openapi.yml
    type: openapi
  - name: confluenceApi
    url: https://raw.githubusercontent.com/api-evangelist/confluence/refs/heads/main/openapi/confluence-cloud-v2.yml
    type: openapi
  - name: slackChat
    url: https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-chat-openapi.yml
    type: openapi
workflows:
  - workflowId: resolved-postmortem
    summary: Resolve an incident, publish a postmortem page, then notify Slack.
    description: >-
      Updates a ServiceNow incident to resolved, publishes a Confluence postmortem
      page, and posts a Slack notification linking the team to the writeup.
    inputs:
      type: object
      properties:
        tableName:
          type: string
        incidentSysId:
          type: string
        closeNotes:
          type: string
        confluenceSpaceId:
          type: string
        postmortemTitle:
          type: string
        postmortemBody:
          type: string
        slackChannel:
          type: string
    steps:
      - stepId: resolve-incident
        description: Update the ServiceNow incident to a resolved state.
        operationId: $sourceDescriptions.servicenowTable.updateRecord
        parameters:
          - name: tableName
            in: path
            value: $inputs.tableName
          - name: sys_id
            in: path
            value: $inputs.incidentSysId
        requestBody:
          contentType: application/json
          payload:
            state: '6'
            close_notes: $inputs.closeNotes
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          incidentNumber: $response.body#/result/number
          incidentState: $response.body#/result/state
      - stepId: publish-postmortem
        description: Publish a Confluence postmortem page for the incident.
        operationId: $sourceDescriptions.confluenceApi.createPage
        requestBody:
          contentType: application/json
          payload:
            spaceId: $inputs.confluenceSpaceId
            status: current
            title: $inputs.postmortemTitle
            body:
              representation: storage
              value: $inputs.postmortemBody
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          pageId: $response.body#/id
      - stepId: notify-slack
        description: Notify the team in Slack that the postmortem is published.
        operationId: $sourceDescriptions.slackChat.postChatPostmessage
        requestBody:
          contentType: application/x-www-form-urlencoded
          payload:
            channel: $inputs.slackChannel
            text: Incident resolved and postmortem published in Confluence.
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          messageTs: $response.body#/ts
    outputs:
      incidentNumber: $steps.resolve-incident.outputs.incidentNumber
      pageId: $steps.publish-postmortem.outputs.pageId
      messageTs: $steps.notify-slack.outputs.messageTs