PagerDuty Incident to GitHub Issue to Slack

arazzo: 1.0.1
info:
  title: PagerDuty Incident to GitHub Issue to Slack
  summary: Trigger a PagerDuty incident, open a GitHub issue, then notify Slack.
  description: >-
    An incident-response workflow that triggers a PagerDuty incident to page the
    on-call engineer, opens a GitHub issue to track remediation, and posts a
    Slack notification so the team can coordinate. Demonstrates chaining an
    incident-management provider, a source-control provider, and a chat provider
    in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: pagerdutyApi
    url: https://raw.githubusercontent.com/api-evangelist/pagerduty/refs/heads/main/openapi/pagerduty-openapi-original.yml
    type: openapi
  - name: githubIssues
    url: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/github-repo-issues-api-openapi.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: pagerduty-incident-to-issue-to-slack
    summary: Trigger a PagerDuty incident, open a GitHub issue, and notify Slack.
    description: >-
      Triggers a PagerDuty incident, opens a GitHub issue that tracks the
      incident, and posts a Slack message linking responders to the issue.
    inputs:
      type: object
      properties:
        incidentTitle:
          type: string
        serviceId:
          type: string
        owner:
          type: string
        repo:
          type: string
        slackChannel:
          type: string
    steps:
      - stepId: trigger-incident
        description: Trigger a new incident in PagerDuty.
        operationId: $sourceDescriptions.pagerdutyApi.createIncident
        requestBody:
          contentType: application/json
          payload:
            incident:
              type: incident
              title: $inputs.incidentTitle
              service:
                id: $inputs.serviceId
                type: service_reference
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          incidentId: $response.body#/incident/id
          incidentUrl: $response.body#/incident/html_url
      - stepId: open-issue
        description: Open a GitHub issue to track the PagerDuty incident.
        operationId: $sourceDescriptions.githubIssues.createAnIssue
        requestBody:
          contentType: application/json
          payload:
            title: $inputs.incidentTitle
            body: $steps.trigger-incident.outputs.incidentUrl
            labels:
              - incident
              - pagerduty
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          issueNumber: $response.body#/number
          issueUrl: $response.body#/html_url
      - stepId: notify-slack
        description: Notify the incident Slack channel with the issue link.
        operationId: $sourceDescriptions.slackChat.postChatPostmessage
        requestBody:
          contentType: application/json
          payload:
            channel: $inputs.slackChannel
            text: $steps.open-issue.outputs.issueUrl
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          messageTs: $response.body#/ts
    outputs:
      incidentId: $steps.trigger-incident.outputs.incidentId
      issueNumber: $steps.open-issue.outputs.issueNumber
      issueUrl: $steps.open-issue.outputs.issueUrl
      messageTs: $steps.notify-slack.outputs.messageTs