# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AppConnect V3 Automations API
  version: 1.0.0
extends: openapi/constant-contact-automations-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/automations/workflows'].get
  update:
    x-apievangelist-phrasing:
      intent: List automation workflows
      effect: read
      questions:
      - Which automation workflows do I have set up?
      - Can I find automations by name or only those created after a certain date?
      instructions:
      - text: List all my automations.
      - text: Find automations named {name}.
        slots:
          name: query.name
      - text: List automations created since {created_from}.
        slots:
          created_from: query.created_from
      method: generated
      generated: '2026-10-01'
- target: $.paths['/automations/workflows'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an automation workflow
      effect: write
      questions:
      - Can I build an automation that triggers when a contact joins a list?
      - Is there a way to set up a birthday automation from scratch?
      instructions:
      - text: Create an automation called {workflowName}.
        slots:
          workflowName: query.workflowName
      - text: Create an automation {workflowName} triggered for contacts in segment {segment_id}.
        slots:
          workflowName: query.workflowName
          segment_id: requestBody.segment_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/automations/workflows/{automation_flow_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one automation workflow
      effect: read
      questions:
      - What triggers and steps are in a specific automation?
      - Can I look up an automation by its workflow ID?
      instructions:
      - text: Show automation workflow {automation_flow_id}.
        slots:
          automation_flow_id: path.automation_flow_id
      - text: Get the details of automation {automation_flow_id}.
        slots:
          automation_flow_id: path.automation_flow_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/automations/workflows/{automation_flow_id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update an automation workflow
      effect: write
      questions:
      - Can I edit an existing automation after it's been created?
      - What do I send to change the steps of an automation workflow?
      instructions:
      - text: Update automation workflow {automation_flow_id} with {automation_flow}.
        slots:
          automation_flow_id: path.automation_flow_id
          automation_flow: requestBody.automation_flow
      - text: Save my changes to automation {automation_flow_id}.
        slots:
          automation_flow_id: path.automation_flow_id
      method: generated
      generated: '2026-10-01'