Pipedream Configure Project Environment Webhook

arazzo: 1.0.1
info:
  title: Pipedream Configure Project Environment Webhook
  summary: Set the project environment webhook URL, then read it back to confirm.
  description: >-
    A configuration flow for the project-wide Connect webhook that receives
    account and event notifications for an environment. The workflow sets the
    webhook URL for the project environment and then retrieves it to confirm the
    URL is in place. Every step spells out its request inline so the flow can be
    read and executed without opening the underlying OpenAPI description.
  version: 1.0.0
sourceDescriptions:
- name: webhooksApi
  url: ../openapi/pipedream-webhooks-api-openapi.yml
  type: openapi
workflows:
- workflowId: project-environment-webhook
  summary: Set and verify the project environment webhook URL.
  description: >-
    Sets the webhook URL for the project environment, then retrieves the webhook
    to confirm the URL was stored.
  inputs:
    type: object
    required:
    - projectId
    - environment
    - url
    properties:
      projectId:
        type: string
        description: The project ID, which starts with proj_.
      environment:
        type: string
        description: The Connect environment (development or production).
      url:
        type: string
        description: The webhook URL to receive project environment notifications.
  steps:
  - stepId: setWebhook
    description: >-
      Create or update the project environment webhook with the supplied URL.
    operationId: updateProjectEnvironmentWebhook
    parameters:
    - name: project_id
      in: path
      value: $inputs.projectId
    - name: x-pd-environment
      in: header
      value: $inputs.environment
    requestBody:
      contentType: application/json
      payload:
        url: $inputs.url
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      webhook: $response.body#/data
  - stepId: verifyWebhook
    description: >-
      Retrieve the project environment webhook to confirm the supplied URL is
      configured.
    operationId: retrieveProjectEnvironmentWebhook
    parameters:
    - name: project_id
      in: path
      value: $inputs.projectId
    - name: x-pd-environment
      in: header
      value: $inputs.environment
    successCriteria:
    - condition: $statusCode == 200
    outputs:
      webhook: $response.body#/data
  outputs:
    setWebhook: $steps.setWebhook.outputs.webhook
    verifiedWebhook: $steps.verifyWebhook.outputs.webhook