# 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 Data elements API
  version: 1.0.0
extends: openapi/adobe-launch-data-elements-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: 14
- 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 tag property's data elements by published or enabled state?
      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 web tag property?
      - What goes in the payload to create a tag data element?
      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['/data_elements/{DATA_ELEMENT_ID}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a tag data element
      effect: read
      questions:
      - How can I see how one tag data element is configured?
      - Is a particular tag data element published?
      instructions:
      - text: Retrieve tag data element {DATA_ELEMENT_ID}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      - text: Show the settings of tag data element {DATA_ELEMENT_ID}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{DATA_ELEMENT_ID}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a tag data element
      effect: write
      questions:
      - Does the data element ID have to appear in both the path and the payload when editing a tag data element?
      - How do I change a tag data element's settings?
      instructions:
      - text: Update tag data element {DATA_ELEMENT_ID} with {data}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
          data: requestBody.data
      - text: Rename tag data element {DATA_ELEMENT_ID}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{DATA_ELEMENT_ID}/notes'].get
  update:
    x-apievangelist-phrasing:
      intent: List the notes on a data element
      effect: read
      questions:
      - What notes have been left on a data element?
      - Can I search a data element's notes for a word?
      instructions:
      - text: List the notes on data element {DATA_ELEMENT_ID}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      - text: Find notes on data element {DATA_ELEMENT_ID} mentioning {text}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
          text: query.text
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{DATA_ELEMENT_ID}/notes'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a note to a data element
      effect: write
      questions:
      - How do I leave a note on a data element for other editors?
      - Can I document what a data element captures with a note?
      instructions:
      - text: Add a note to data element {DATA_ELEMENT_ID}.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      - text: Write a note on data element {DATA_ELEMENT_ID} describing its source.
        slots:
          DATA_ELEMENT_ID: path.DATA_ELEMENT_ID
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/data_elements'].get
  update:
    x-apievangelist-phrasing:
      intent: List an event forwarding property's data elements
      effect: read
      questions:
      - Which data elements exist on my event forwarding property?
      - Can I filter event forwarding data elements by name or enabled flag?
      instructions:
      - text: List the data elements on event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Find event forwarding data elements named {name} on property {propertyId}.
        slots:
          propertyId: path.propertyId
          name: query.filter[name]
      method: generated
      generated: '2026-09-26'
- target: $.paths['/properties/{propertyId}/data_elements'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an event forwarding data element
      effect: write
      questions:
      - How do I add a data element to a server-side event forwarding property?
      - Can I create event forwarding data elements through the API?
      instructions:
      - text: Create a data element on event forwarding property {propertyId}.
        slots:
          propertyId: path.propertyId
      - text: Add an event forwarding data element to property {propertyId} using {data}.
        slots:
          propertyId: path.propertyId
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an event forwarding data element
      effect: read
      questions:
      - How do I look up an event forwarding data element by its ID?
      - What are the attributes of a server-side data element?
      instructions:
      - text: Fetch event forwarding data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      - text: Show the attributes of server-side data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data element
      effect: destructive
      questions:
      - How do I remove a data element I no longer use?
      - Can a data element be deleted permanently?
      instructions:
      - text: Delete data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      - text: Permanently remove the unused data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an event forwarding data element
      effect: write
      questions:
      - How do I edit an event forwarding data element's attributes?
      - Can I disable a server-side data element without deleting it?
      instructions:
      - text: Update event forwarding data element {dataElementId} with {data}.
        slots:
          dataElementId: path.dataElementId
          data: requestBody.data
      - text: Disable server-side data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}/revisions'].get
  update:
    x-apievangelist-phrasing:
      intent: List a data element's revisions
      effect: read
      questions:
      - What is the revision history of a data element?
      - Can I see earlier versions of a data element?
      instructions:
      - text: List the revisions of data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      - text: Show the revision history for data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}/extension'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the extension behind a data element
      effect: read
      questions:
      - Which extension provides a given data element type?
      - What extension does this data element depend on?
      instructions:
      - text: Get the extension for data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      - text: Tell me which extension data element {dataElementId} comes from.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/data_elements/{dataElementId}/property'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the property that owns a data element
      effect: read
      questions:
      - Which property does a given data element belong to?
      - How can I trace a data element back to its property?
      instructions:
      - text: Get the property that owns data element {dataElementId}.
        slots:
          dataElementId: path.dataElementId
      - text: Tell me which property data element {dataElementId} lives in.
        slots:
          dataElementId: path.dataElementId
      method: generated
      generated: '2026-09-26'