# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Automation Actions V4 Callbacks API
  version: 1.0.0
extends: openapi/hubspot-callbacks-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 2
- target: $.paths['/automation/actions/callbacks/2026-09/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Complete many blocked workflow actions at once
      effect: write
      questions:
      - How do I resume a bunch of workflow actions that are waiting on my app?
      - Can I complete several blocked custom action executions in a single request?
      instructions:
      - text: 'Complete this batch of blocked action callbacks: {inputs}.'
        slots:
          inputs: requestBody.inputs
      - text: Release all the waiting workflow executions listed in {inputs}.
        slots:
          inputs: requestBody.inputs
      method: generated
      generated: '2026-09-24'
- target: $.paths['/automation/actions/callbacks/2026-09/{callbackId}/complete'].post
  update:
    x-apievangelist-phrasing:
      intent: Complete one blocked workflow action
      effect: write
      questions:
      - How do I tell a workflow that my app finished processing one blocked action?
      - Can I report a failure reason when completing a single action callback?
      instructions:
      - text: Complete callback {callbackId} with output fields {outputFields} and typed outputs {typedOutputs}.
        slots:
          callbackId: path.callbackId
          outputFields: requestBody.outputFields
          typedOutputs: requestBody.typedOutputs
      - text: Finish callback {callbackId} as failed with reason {failureReasonType}, outputs {outputFields} and typed outputs {typedOutputs}.
        slots:
          callbackId: path.callbackId
          failureReasonType: requestBody.failureReasonType
          outputFields: requestBody.outputFields
          typedOutputs: requestBody.typedOutputs
      method: generated
      generated: '2026-09-24'