# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Analytics 2.0 Component Migration API. Dimensions mappings API
  version: 1.0.0
extends: openapi/adobe-analytics-dimensions-mappings-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/mapping/dimensions/csv'].get
  update:
    x-apievangelist-phrasing:
      intent: Download dimension mappings as CSV
      effect: read
      questions:
      - How do I export the dimension mappings between a report suite and a data view?
      - Can I download mappings for only certain dimensions?
      instructions:
      - text: Download dimension mappings CSV for report suite {rsid} and data view {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
      - text: Export mappings for dimensions {dimensionIds} on {rsid} and data view {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
          dimensionIds: query.dimensionIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mapping/dimensions/csv'].put
  update:
    x-apievangelist-phrasing:
      intent: Update dimension mappings from CSV
      effect: write
      questions:
      - Can I edit existing dimension mappings by uploading a revised CSV?
      - How do I change some dimension mappings for a report suite and data view?
      instructions:
      - text: Update dimension mappings for {rsid} and data view {dataId} with CSV {file}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
          file: requestBody.file
      - text: Apply my edited dimension mapping CSV {file} to report suite {rsid}, data view {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
          file: requestBody.file
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mapping/dimensions/csv'].post
  update:
    x-apievangelist-phrasing:
      intent: Replace dimension mappings with a CSV
      effect: write
      questions:
      - How do I upload a CSV that overrides all current dimension mappings?
      - Can I create fresh dimension mappings for a report suite from a file?
      instructions:
      - text: Upload CSV {file} to override dimension mappings for {rsid} and data view {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
          file: requestBody.file
      - text: Create new dimension mappings on report suite {rsid}, data view {dataId}, from {file}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
          file: requestBody.file
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mapping/dimensions/all'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete all dimension mappings
      effect: destructive
      questions:
      - How do I wipe every dimension mapping for a report suite and data view?
      - What happens if I clear dimension mappings when none exist?
      instructions:
      - text: Delete all dimension mappings for report suite {rsid} and data view {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
      - text: Clear every dimension mapping between {rsid} and {dataId}.
        slots:
          rsid: query.rsid
          dataId: query.dataId
      method: generated
      generated: '2026-10-01'