# 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 Rules API
  version: 1.0.0
extends: openapi/adobe-launch-rules-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: 23
- target: $.paths['/properties/{PROPERTY_ID}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's rules
      effect: read
      questions:
      - Which rules are set up on my web tag property?
      - Can I narrow a property's rule list to the ones with unpublished (dirty) changes?
      instructions:
      - text: List every rule in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show the rules named {name} in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a rule in a tag property
      effect: write
      questions:
      - How do I add a rule to a web or mobile tag property?
      - What does a new tag rule need before it can hold events and actions?
      instructions:
      - text: Create a new rule in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Add a rule to tag property {PROPERTY_ID} with attributes {data}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag rule's details
      effect: read
      questions:
      - How can I pull up a single tag rule by its ID?
      - Is a particular tag rule enabled and published right now?
      instructions:
      - text: Fetch tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show me the attributes of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag rule
      effect: destructive
      questions:
      - How do I delete a tag rule we no longer fire?
      - Can a tag rule be removed entirely rather than just disabled?
      instructions:
      - text: Delete tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Permanently remove the tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update or revise a tag rule
      effect: write
      questions:
      - Can I save a new revision of a tag rule instead of overwriting the current one?
      - How do I rename or disable an existing tag rule?
      instructions:
      - text: Update tag rule {RULE_ID} with {data}.
        slots:
          RULE_ID: path.RULE_ID
          data: requestBody.data
      - text: Create a new revision of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/rule_components'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag rule's components
      effect: read
      questions:
      - What events, conditions and actions make up a tag rule?
      - Can I list only the negated conditions on a tag rule?
      instructions:
      - text: List the components of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show enabled components of tag rule {RULE_ID}, {size} per page.
        slots:
          RULE_ID: path.RULE_ID
          size: query.page[size]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/rule_components'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a component to a tag rule
      effect: write
      questions:
      - How do I attach a new event, condition or action to a tag rule?
      - Can I add a rule component directly under a rule ID?
      instructions:
      - text: Add a component to tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: 'Create this rule component under tag rule {RULE_ID}: {data}.'
        slots:
          RULE_ID: path.RULE_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List libraries that include a tag rule
      effect: read
      questions:
      - Which libraries is a given tag rule part of?
      - Has this tag rule been added to any library yet?
      instructions:
      - text: List the libraries that use tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show which libraries tag rule {RULE_ID} is bundled into.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property that owns a tag rule
      effect: read
      questions:
      - Which tag property does this rule belong to?
      - How can I trace a tag rule back to its property?
      instructions:
      - text: Get the tag property that owns rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Tell me which tag property rule {RULE_ID} lives in.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/origin'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the origin of a revised tag rule
      effect: read
      questions:
      - How do I find the original rule a tag rule revision came from?
      - Can I get back to the source rule of a revision?
      instructions:
      - text: Retrieve the origin of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show the original tag rule that revision {RULE_ID} was made from.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag rule's revisions
      effect: read
      questions:
      - What revisions have been made to a tag rule over time?
      - Can I page through every saved revision of a tag rule?
      instructions:
      - text: List the revisions of tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Show page {number} of revisions for tag rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
          number: query.page[number]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/rule_component_notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List notes on a rule's components
      effect: read
      questions:
      - What notes have been left on the events, conditions and actions of a rule?
      - Can I see component-level notes for a rule, excluding notes on the rule itself?
      instructions:
      - text: List the notes attached to the components of rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Find component notes under rule {RULE_ID} that mention {text}.
        slots:
          RULE_ID: path.RULE_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List notes on a rule
      effect: read
      questions:
      - What notes are attached directly to a rule?
      - Can I filter a rule's own notes by their text?
      instructions:
      - text: List the notes on rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Find notes on rule {RULE_ID} containing {text}.
        slots:
          RULE_ID: path.RULE_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{RULE_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a rule
      effect: write
      questions:
      - How do I leave a comment on a rule for my teammates?
      - Can I annotate a rule with a note explaining why it changed?
      instructions:
      - text: Add a note to rule {RULE_ID}.
        slots:
          RULE_ID: path.RULE_ID
      - text: Write a note on rule {RULE_ID} describing the latest change.
        slots:
          RULE_ID: path.RULE_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event forwarding property's rules
      effect: read
      questions:
      - Which server-side rules exist on my event forwarding property?
      - Can I filter event forwarding rules by name or enabled state?
      instructions:
      - text: List the event forwarding rules on property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Find event forwarding rules named {name} on property {propertyId}.
        slots:
          propertyId: path.propertyId
          name: query.filter[name]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/rules'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an event forwarding rule
      effect: write
      questions:
      - How do I add a server-side processing rule to an event forwarding property?
      - Can I create a new event forwarding rule through the API?
      instructions:
      - text: Create an event forwarding rule on property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Add a server-side event forwarding rule to property {propertyId} using {data}.
        slots:
          propertyId: path.propertyId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding rule
      effect: read
      questions:
      - How do I look up a single event forwarding rule by ID?
      - What are the current settings of an event forwarding rule?
      instructions:
      - text: Fetch event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Show the attributes of event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event forwarding rule
      effect: destructive
      questions:
      - How do I remove a server-side event forwarding rule?
      - Can an event forwarding rule be deleted outright?
      instructions:
      - text: Delete event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Remove the event forwarding rule {ruleId} for good.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an event forwarding rule
      effect: write
      questions:
      - How do I change the name or enabled state of an event forwarding rule?
      - Can I edit a server-side rule's attributes after creating it?
      instructions:
      - text: Update event forwarding rule {ruleId} with {data}.
        slots:
          ruleId: path.ruleId
          data: requestBody.data
      - text: Disable event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List libraries using an event forwarding rule
      effect: read
      questions:
      - Which libraries contain a given event forwarding rule?
      - Is my server-side rule included in any library build yet?
      instructions:
      - text: List the libraries that use event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Show which libraries include server-side rule {ruleId}.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event forwarding rule's revisions
      effect: read
      questions:
      - What is the revision history of an event forwarding rule?
      - Can I see earlier versions of a server-side rule?
      instructions:
      - text: List the revisions of event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Show the revision history for server-side rule {ruleId}.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}/origin'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding rule's previous revision
      effect: read
      questions:
      - How do I get the previous revision of an event forwarding rule?
      - Which rule did this server-side rule revision originate from?
      instructions:
      - text: Get the origin of event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Show the prior revision that event forwarding rule {ruleId} came from.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/rules/{ruleId}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property of an event forwarding rule
      effect: read
      questions:
      - Which event forwarding property owns this rule?
      - How can I find the edge property a server-side rule belongs to?
      instructions:
      - text: Get the property that owns event forwarding rule {ruleId}.
        slots:
          ruleId: path.ruleId
      - text: Tell me which edge property server-side rule {ruleId} is in.
        slots:
          ruleId: path.ruleId
      method: generated
      generated: '2026-09-26'