# 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 Properties API
  version: 1.0.0
extends: openapi/adobe-launch-properties-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: 30
- target: $.paths['/companies/{COMPANY_ID}/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: List a company's tag properties
      effect: read
      questions:
      - How do I see every tag property my company owns in Adobe Launch?
      - Can I filter a company's properties to only the enabled ones or a single platform?
      instructions:
      - text: List all tag properties for company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: Show only the enabled properties under company {COMPANY_ID} on platform {platform}.
        slots:
          COMPANY_ID: path.COMPANY_ID
          platform: query.platform
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{COMPANY_ID}/properties'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag property for a company
      effect: write
      questions:
      - What do I need to set up a new web or mobile tag property under my company?
      - Can I add another tag property to a company that already has several?
      instructions:
      - text: Create a new tag property under company {COMPANY_ID}.
        slots:
          COMPANY_ID: path.COMPANY_ID
      - text: 'Add a tag property to company {COMPANY_ID} using these settings: {data}.'
        slots:
          COMPANY_ID: path.COMPANY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag property's details
      effect: read
      questions:
      - How can I look up the settings of one tag property by its ID?
      - Which platform and domains is a given tag property configured for?
      instructions:
      - text: Fetch tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show me the details and attributes of tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a tag property
      effect: destructive
      questions:
      - How do I permanently remove a tag property I no longer use?
      - Can a tag property be deleted through the API instead of the UI?
      instructions:
      - text: Delete tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Remove the unused tag property {PROPERTY_ID} from our account.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tag property's settings
      effect: write
      questions:
      - How do I rename a tag property or change its domains?
      - Can I edit the attributes of an existing tag property after it is created?
      instructions:
      - text: 'Update tag property {PROPERTY_ID} with these attributes: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      - text: Change the settings on tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/company'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the company that owns a tag property
      effect: read
      questions:
      - Which company does a particular tag property belong to?
      - How can I trace a tag property back to its owning company?
      instructions:
      - text: Look up the company that owns tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Tell me which company tag property {PROPERTY_ID} sits under.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/callbacks'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's callbacks
      effect: read
      questions:
      - What callback URLs are registered on my tag property?
      - Can I page through the callbacks configured for a property?
      instructions:
      - text: List the callbacks on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show callbacks for property {PROPERTY_ID}, {size} per page.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          size: query.page[size]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/callbacks'].post
  update:
    x-apievangelist-phrasing:
      intent: Register a callback on a property
      effect: write
      questions:
      - How do I get notified at my own URL when things change in a tag property?
      - Can I register a callback endpoint for a property's events?
      instructions:
      - text: Create a callback on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: 'Register this callback configuration on property {PROPERTY_ID}: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/data_elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's data elements
      effect: read
      questions:
      - Which data elements are defined in my tag property?
      - Can I filter a property's data elements to only published or enabled ones?
      instructions:
      - text: List the data elements in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Find data elements 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}/data_elements'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data element in a tag property
      effect: write
      questions:
      - How do I add a new data element to a tag property?
      - What goes into the payload when creating a data element for a web property?
      instructions:
      - text: Create a data element in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Add a data element to tag property {PROPERTY_ID} defined as {data}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/environments'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's environments
      effect: read
      questions:
      - What development, staging and production environments does my property have?
      - Can I list only the environments in a particular stage?
      instructions:
      - text: List the environments for property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show the {stage} environments of property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          stage: query.stage
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/environments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an environment for a property
      effect: write
      questions:
      - How do I add a new development environment to a property?
      - Can I create a staging environment for testing library builds?
      instructions:
      - text: Create an environment on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: 'Add an environment to property {PROPERTY_ID} with these settings: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's installed extensions
      effect: read
      questions:
      - Which extensions are installed on my tag property?
      - Can I see what version of each extension a property is running?
      instructions:
      - text: List the extensions installed on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Find the extension called {display_name} on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          display_name: query.display_name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/extensions'].post
  update:
    x-apievangelist-phrasing:
      intent: Install an extension on a property
      effect: write
      questions:
      - How do I install an extension package onto a tag property?
      - Can I add an extension to a property through the API?
      instructions:
      - text: Install an extension on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: 'Add this extension to property {PROPERTY_ID}: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/hosts'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's hosts
      effect: read
      questions:
      - Where are my property's library builds hosted?
      - Can I list the hosts configured on a tag property?
      instructions:
      - text: List the hosts on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show hosts named {name} on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          name: query.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/hosts'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a host to a property
      effect: write
      questions:
      - How do I set up a self-hosted SFTP location for my property's builds?
      - Can I add a new host to deliver a property's libraries?
      instructions:
      - text: Create a host on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Add a host to property {PROPERTY_ID} configured as {data}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/libraries'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's libraries
      effect: read
      questions:
      - Which libraries exist on my tag property?
      - Can I find libraries that are stale or in a particular state?
      instructions:
      - text: List the libraries on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show libraries in state {state} on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          state: query.state
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/libraries'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a library on a property
      effect: write
      questions:
      - How do I start a new library to bundle rule and data element changes?
      - Can I create a library for a property through the API?
      instructions:
      - text: Create a library on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Start a new library on property {PROPERTY_ID} with {data}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/rules'].get
  update:
    x-apievangelist-phrasing:
      intent: List a tag property's rules
      effect: read
      questions:
      - What rules are defined on my tag property?
      - Can I list only a property's rules that have unpublished changes?
      instructions:
      - text: List the rules in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show enabled 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 new rule to a web tag property?
      - Can I create a tag rule programmatically?
      instructions:
      - text: Create a rule in tag property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Add a rule to tag property {PROPERTY_ID} defined as {data}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/secrets'].get
  update:
    x-apievangelist-phrasing:
      intent: List a property's secrets
      effect: read
      questions:
      - What secrets are stored on my property?
      - Can I filter a property's secrets by status or by environment?
      instructions:
      - text: List the secrets on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Show secrets on property {PROPERTY_ID} scoped to environment {environment_id}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          environment_id: query.environment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/secrets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a secret on a property
      effect: write
      questions:
      - How do I store a credential on a property for use in rules?
      - Can I add a new secret to a property?
      instructions:
      - text: Create a secret on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: 'Add this secret to property {PROPERTY_ID}: {data}.'
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on a property
      effect: read
      questions:
      - What notes have been left on my tag property?
      - Can I search a property's notes by their text?
      instructions:
      - text: List the notes on property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Find notes on property {PROPERTY_ID} mentioning {text}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{PROPERTY_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a property
      effect: write
      questions:
      - How do I leave a note on a tag property for my team?
      - Can I annotate a property with a comment?
      instructions:
      - text: Add a note to property {PROPERTY_ID}.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      - text: Write a note on property {PROPERTY_ID} explaining this week's changes.
        slots:
          PROPERTY_ID: path.PROPERTY_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{companyId}/properties'].get
  update:
    x-apievangelist-phrasing:
      intent: List a company's event forwarding properties
      effect: read
      questions:
      - Which event forwarding properties does my company have?
      - Can I list only the edge-platform properties and filter them by name?
      instructions:
      - text: List event forwarding properties for company {companyId} on platform {platform}.
        slots:
          companyId: path.companyId
          platform: query.filter[platform]
      - text: Find the event forwarding property named {name} in company {companyId} with platform {platform}.
        slots:
          companyId: path.companyId
          platform: query.filter[platform]
          name: query.filter[name]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/companies/{companyId}/properties'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an event forwarding property
      effect: write
      questions:
      - How do I set up a new edge property for server-side event forwarding?
      - Can I create an event forwarding property under my company?
      instructions:
      - text: Create an event forwarding property under company {companyId}.
        slots:
          companyId: path.companyId
      - text: Create an edge property for event forwarding in company {companyId} using {data}.
        slots:
          companyId: path.companyId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding property
      effect: read
      questions:
      - How do I look up one event forwarding property by its ID?
      - What settings does my event forwarding property have?
      instructions:
      - text: Fetch event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Show the attributes of event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an event forwarding property
      effect: destructive
      questions:
      - How do I remove an event forwarding property I no longer need?
      - Can I delete an edge property used for event forwarding?
      instructions:
      - text: Delete event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Remove the event forwarding property {propertyId} permanently.
        slots:
          propertyId: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an event forwarding property
      effect: write
      questions:
      - How do I rename or reconfigure an event forwarding property?
      - Can I change the attributes of an existing edge property?
      instructions:
      - text: Update event forwarding property {propertyId} with {data}.
        slots:
          propertyId: path.propertyId
          data: requestBody.data
      - text: Change the settings of event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/company'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the company behind an event forwarding property
      effect: read
      questions:
      - Which company owns a given event forwarding property?
      - How can I get the parent company of an edge property?
      instructions:
      - text: Get the company that owns event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Show the parent company of edge property {propertyId}.
        slots:
          propertyId: path.propertyId
      method: generated
      generated: '2026-09-26'