# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Launch Rule components API
  version: 1.0.0
extends: openapi/adobe-launch-rule-components-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 16
- target: $.paths['/rules/{RULE_ID}/rule_components'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag rule's components
      effect: read
      questions:
      - Which events, conditions and actions belong to a tag rule?
      - Can I list only the negated components of a tag rule?
      instructions:
      - text: List the components of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show components named {name} in tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/rule_components'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a component under a tag rule
      effect: write
      questions:
      - How do I add an event or action to a tag rule by posting to the rule itself?
      - Can I create a rule component nested directly under a rule ID?
      instructions:
      - text: Create a component under tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: 'Add this action to tag rule {RULE_ID}: {data}.'
        slots:
          RULE_ID: path.RULE_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag rule component
      effect: read
      questions:
      - How can I view the settings of one tag rule component?
      - Is a given tag rule component enabled and published?
      instructions:
      - text: Retrieve tag rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Show the settings of tag rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag rule component
      effect: destructive
      questions:
      - How do I remove a condition from a tag rule?
      - Can I delete a single event or action without deleting its tag rule?
      instructions:
      - text: Delete tag rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Remove the condition {RULE_COMPONENT_ID} from its tag rule.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tag rule component
      effect: write
      questions:
      - Does the component ID need to match in both the path and the payload when editing a tag rule component?
      - How do I change the settings of a tag rule's action?
      instructions:
      - text: Update tag rule component {RULE_COMPONENT_ID} with {data}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
          data: requestBody.data
      - text: Disable tag rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}/extension'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the extension behind a tag rule component
      effect: read
      questions:
      - Which extension provides a given tag rule component?
      - What extension do I need installed for this tag rule action to work?
      instructions:
      - text: Look up the extension that provides tag rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Tell me which extension tag rule component {RULE_COMPONENT_ID} comes from.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}/origin'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a rule component's origin revision
      effect: read
      questions:
      - Where did this rule component revision originate from?
      - Can I get the original version of a revised rule component?
      instructions:
      - text: Retrieve the origin of rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Show the original rule component that {RULE_COMPONENT_ID} was revised from.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List the rules that use a rule component
      effect: read
      questions:
      - Which rules share a particular rule component?
      - If I change this component, which rules are affected?
      instructions:
      - text: List the rules that use rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Show every rule that relies on component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on a rule component
      effect: read
      questions:
      - What notes have been attached to a rule component?
      - Can I search a rule component's notes by text?
      instructions:
      - text: List the notes on rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Find notes on rule component {RULE_COMPONENT_ID} mentioning {text}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{RULE_COMPONENT_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a rule component
      effect: write
      questions:
      - How do I leave a note on a rule's condition or action?
      - Can I annotate a rule component for reviewers?
      instructions:
      - text: Add a note to rule component {RULE_COMPONENT_ID}.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      - text: Write a note on rule component {RULE_COMPONENT_ID} explaining the condition logic.
        slots:
          RULE_COMPONENT_ID: path.RULE_COMPONENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/rule_components'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule component under a property
      effect: write
      questions:
      - Can I create an event, condition or action at the property level instead of under a rule?
      - How do I create a new rule component for an event forwarding property?
      instructions:
      - text: Create a rule component under property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: 'Create this event forwarding rule component in property {propertyId}: {data}.'
        slots:
          propertyId: path.propertyId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}/rule_components'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event forwarding rule's components
      effect: read
      questions:
      - Which components belong to my event forwarding rule?
      - Can I filter an event forwarding rule's components by published state?
      instructions:
      - text: List the components of event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Show enabled components named {name} in event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
          name: query.filter[name]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{ruleComponentId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding rule component
      effect: read
      questions:
      - How do I look up an event forwarding rule component by ID?
      - What settings does a server-side rule component have?
      instructions:
      - text: Fetch event forwarding rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      - text: Show the attributes of server-side rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{ruleComponentId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event forwarding rule component
      effect: destructive
      questions:
      - How do I remove an action from an event forwarding rule?
      - Can I delete a server-side rule component on its own?
      instructions:
      - text: Delete event forwarding rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      - text: Remove server-side rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{ruleComponentId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an event forwarding rule component
      effect: write
      questions:
      - How do I edit the settings of a server-side rule component?
      - Can I change an event forwarding rule component's attributes?
      instructions:
      - text: Update event forwarding rule component {ruleComponentId} with {data}.
        slots:
          ruleComponentId: path.ruleComponentId
          data: requestBody.data
      - text: Change the settings of server-side rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rule_components/{ruleComponentId}/extension'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the extension for a forwarding rule component
      effect: read
      questions:
      - Which extension supplies a given event forwarding rule component?
      - What extension is a server-side action built on?
      instructions:
      - text: Get the extension for event forwarding rule component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      - text: Show which extension provides server-side component {ruleComponentId}.
        slots:
          ruleComponentId: path.ruleComponentId
      method: generated
      generated: '2026-09-26'