# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Adobe Experience Cloud Adobe Experience Platform Datasets…
  version: 1.0.0
extends: openapi/adobe-experience-cloud-datasets-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['/data/foundation/catalog/dataSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List datasets in the Data Catalog
      effect: read
      questions:
      - Which datasets are registered in our Experience Platform sandbox?
      - Can I page through datasets with a start offset?
      instructions:
      - text: List datasets in sandbox {sandbox}.
        slots:
          sandbox: header.x-sandbox-name
      - text: Show {limit} datasets starting at {start} in sandbox {sandbox}.
        slots:
          limit: query.limit
          start: query.start
          sandbox: header.x-sandbox-name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/foundation/catalog/dataSets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a dataset from an XDM schema
      effect: write
      questions:
      - How do I create a dataset based on an existing XDM schema?
      - What fields are required to register a new dataset?
      instructions:
      - text: Create dataset {name} using schema {schemaRef}.
        slots:
          name: requestBody.name
          schemaRef: requestBody.schemaRef
      - text: Create a dataset named {name} in sandbox {sandbox} from schema {schemaRef}.
        slots:
          name: requestBody.name
          sandbox: header.x-sandbox-name
          schemaRef: requestBody.schemaRef
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/foundation/catalog/dataSets/{datasetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a dataset's metadata
      effect: read
      questions:
      - What schema and settings does a specific dataset use?
      - Where can I check a single dataset's configuration?
      instructions:
      - text: Show dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Get metadata for dataset {datasetId} in sandbox {sandbox}.
        slots:
          datasetId: path.datasetId
          sandbox: header.x-sandbox-name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/data/foundation/catalog/dataSets/{datasetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a dataset and its batches
      effect: destructive
      questions:
      - Does deleting a dataset also remove its ingested batches?
      - Can a deleted dataset be restored?
      instructions:
      - text: Delete dataset {datasetId}.
        slots:
          datasetId: path.datasetId
      - text: Permanently remove dataset {datasetId} from sandbox {sandbox}.
        slots:
          datasetId: path.datasetId
          sandbox: header.x-sandbox-name
      method: generated
      generated: '2026-10-01'