# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Reactor Rule components API version: 1.0.0 extends: openapi/adobe-suite-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: 10 - target: $.paths['/rules/{RULE_ID}/rule_components'].get update: x-apievangelist-phrasing: intent: List the components of a tag rule effect: read questions: - What events, conditions and actions make up a given tag rule? - Can I list a rule's components filtered to only enabled or published ones? instructions: - text: List the components of rule {rule}. slots: rule: path.RULE_ID - text: Show components of rule {rule} where enabled is {enabled}. slots: rule: path.RULE_ID enabled: query.enabled 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 add a new event, condition or action to a rule? - Can I create a rule component directly under an existing rule? instructions: - text: Add a new component to rule {rule}. slots: rule: path.RULE_ID - text: Create rule component {data} on rule {rule}. slots: data: requestBody.data rule: path.RULE_ID method: generated generated: '2026-09-26' - target: $.paths['/rule_components/{RULE_COMPONENT_ID}'].get update: x-apievangelist-phrasing: intent: Retrieve a rule component effect: read questions: - How do I look up one rule component's settings? - Can I see the details of a single event or action in a rule? instructions: - text: Show rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Get the settings of rule component {component}. slots: component: 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 rule component effect: destructive questions: - How do I remove a condition or action from a rule? - Can I delete a single rule component? instructions: - text: Delete rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Remove component {component} from its rule. slots: component: 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 rule component effect: write questions: - Can I change the settings of an existing rule component? - Does the ID in the body have to match the path when updating a rule component? instructions: - text: Update rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Patch rule component {component} with {data}. slots: component: path.RULE_COMPONENT_ID data: requestBody.data 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 rule component effect: read questions: - Which extension provides a particular rule component? - How do I tell what extension an action in my rule comes from? instructions: - text: Show the extension that provides rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Look up which extension rule component {component} belongs to. slots: component: path.RULE_COMPONENT_ID method: generated generated: '2026-09-26' - target: $.paths['/rule_components/{RULE_COMPONENT_ID}/origin'].get update: x-apievangelist-phrasing: intent: Retrieve a rule component's origin effect: read questions: - What is the original revision a rule component was copied from? - Can I trace a rule component back to its origin? instructions: - text: Show the origin of rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Get the origin revision for rule component {component}. slots: component: 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 rules that use a rule component effect: read questions: - Which rules use a particular rule component? - Can I page through every rule that references one component? instructions: - text: List the rules using rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Show {size} rules per page that use component {component}. slots: size: query.page[size] component: 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 notes on a rule component effect: read questions: - What notes have been left on a rule component? - Can I read the comments attached to one rule component? instructions: - text: List notes on rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Show page {number} of notes for rule component {component}. slots: number: query.page[number] component: path.RULE_COMPONENT_ID 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 component? - Can I attach a comment explaining a rule component change? instructions: - text: Add a note to rule component {component}. slots: component: path.RULE_COMPONENT_ID - text: Write a note on rule component {component} for the team. slots: component: path.RULE_COMPONENT_ID method: generated generated: '2026-09-26'