Incident Record to GitHub Issue to Slack

arazzo: 1.0.1
info:
  title: Incident Record to GitHub Issue to Slack
  summary: Log an incident in Airtable, open a GitHub issue, then alert Slack.
  description: >-
    A productivity and internal-ops workflow that logs an incident as an
    Airtable record, opens a GitHub issue so engineering can investigate, and
    alerts the on-call team in Slack. Demonstrates orchestrating a database
    provider, a source-control provider, and a messaging provider in a single
    Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: airtableApi
    url: https://raw.githubusercontent.com/api-evangelist/airtable/refs/heads/main/openapi/airtable-records-api-openapi.yml
    type: openapi
  - name: githubIssuesApi
    url: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/openapi/_original/github-repo-issues-api-openapi.yml
    type: openapi
  - name: slackChatApi
    url: https://raw.githubusercontent.com/api-evangelist/slack/refs/heads/main/openapi/slack-chat-api-openapi.yml
    type: openapi
workflows:
  - workflowId: incident-to-issue-to-slack
    summary: Log an incident, open a GitHub issue, then alert Slack.
    description: >-
      Creates an Airtable incident record, opens a GitHub issue referencing it,
      and posts a Slack alert linking to the new issue.
    inputs:
      type: object
      properties:
        baseId:
          type: string
        tableIdOrName:
          type: string
        incidentTitle:
          type: string
        owner:
          type: string
        repo:
          type: string
        slackChannel:
          type: string
    steps:
      - stepId: log-incident
        description: Log the incident as an Airtable record.
        operationId: $sourceDescriptions.airtableApi.createRecords
        parameters:
          - name: baseId
            in: path
            value: $inputs.baseId
          - name: tableIdOrName
            in: path
            value: $inputs.tableIdOrName
        requestBody:
          contentType: application/json
          payload:
            records:
              - fields:
                  Name: $inputs.incidentTitle
                  Status: Open
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          recordId: $response.body#/records/0/id
      - stepId: open-issue
        description: Open a GitHub issue for the incident.
        operationId: $sourceDescriptions.githubIssuesApi.createAnIssue
        parameters:
          - name: owner
            in: path
            value: $inputs.owner
          - name: repo
            in: path
            value: $inputs.repo
        requestBody:
          contentType: application/json
          payload:
            title: $inputs.incidentTitle
            body: $steps.log-incident.outputs.recordId
        successCriteria:
          - condition: $statusCode == 201
        outputs:
          issueUrl: $response.body#/html_url
      - stepId: alert-oncall
        description: Alert the on-call team in Slack.
        operationId: $sourceDescriptions.slackChatApi.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:
      recordId: $steps.log-incident.outputs.recordId
      issueUrl: $steps.open-issue.outputs.issueUrl
      messageTs: $steps.alert-oncall.outputs.messageTs