Sysdig Compliance Finding to SendGrid Email

arazzo: 1.0.1
info:
  title: Sysdig Compliance Finding to SendGrid Email
  summary: Pull Sysdig compliance tasks and results, then email a summary via SendGrid.
  description: >-
    A compliance reporting workflow that lists Sysdig Secure compliance tasks, retrieves the
    results for a selected task, and emails a compliance summary to a stakeholder through
    SendGrid's Mail Send API. Demonstrates orchestrating a cloud security posture platform
    with a communications provider in a single Arazzo workflow.
  version: 1.0.0
sourceDescriptions:
  - name: sysdigSecureApi
    url: https://raw.githubusercontent.com/api-evangelist/sysdig/refs/heads/main/openapi/sysdig-secure-openapi.yml
    type: openapi
  - name: sendgridMailApi
    url: https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/tsg_mail_v3.yaml
    type: openapi
workflows:
  - workflowId: compliance-results-email
    summary: List Sysdig compliance tasks, get results, and email a summary via SendGrid.
    description: >-
      Lists Sysdig Secure compliance tasks, retrieves the results for a task, and sends a
      compliance summary email through SendGrid.
    inputs:
      type: object
      properties:
        taskId:
          type: string
        recipientEmail:
          type: string
    steps:
      - stepId: list-tasks
        description: List compliance tasks configured in Sysdig Secure.
        operationId: $sourceDescriptions.sysdigSecureApi.listComplianceTasks
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          taskCount: $response.body#/total
      - stepId: get-results
        description: Retrieve compliance results for the selected task.
        operationId: $sourceDescriptions.sysdigSecureApi.getComplianceResults
        parameters:
          - name: taskId
            in: path
            value: $inputs.taskId
        successCriteria:
          - condition: $statusCode == 200
        outputs:
          passPercent: $response.body#/passPercent
      - stepId: email-summary
        description: Email the compliance summary to a stakeholder via SendGrid Mail Send.
        operationId: $sourceDescriptions.sendgridMailApi.SendMail
        requestBody:
          contentType: application/json
          payload:
            personalizations:
              - to:
                  - email: $inputs.recipientEmail
                subject: Sysdig compliance results summary
            from:
              email: [email protected]
            content:
              - type: text/plain
                value: Your Sysdig Secure compliance task results are ready for review.
        successCriteria:
          - condition: $statusCode == 202
        outputs:
          messageStatus: $statusCode
    outputs:
      passPercent: $steps.get-results.outputs.passPercent
      messageStatus: $steps.email-summary.outputs.messageStatus