API Evangelist conversational phrasing for Lucid Data Data Set API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Lucid Data Data Set API
  version: 1.0.0
extends: openapi/lucid-dataset-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: 6
- target: $.paths['/dataSets'].get
  update:
    x-apievangelist-phrasing:
      intent: List all data sets I can access
      effect: read
      questions:
      - Which data sets do I have access to in Lucid?
      - Can I page through data sets using a start and end range?
      instructions:
      - text: List all my data sets.
      - text: Get data sets from {start} to {end}.
        slots:
          start: query.start
          end: query.end
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSets'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data set
      effect: write
      questions:
      - How do I create a new data set to group data sources?
      - Can I create a data set that already contains data sources?
      instructions:
      - text: Create a data set named {name}.
        slots:
          name: requestBody.name
      - text: Create data set {name} with properties {properties}.
        slots:
          name: requestBody.name
          properties: requestBody.properties
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSets'].head
  update:
    x-apievangelist-phrasing:
      intent: Count the data sets I can access
      effect: read
      questions:
      - How many data sets do I have access to?
      - Is there a way to get just the total number of data sets?
      instructions:
      - text: Count my data sets.
      - text: Tell me the total number of data sets I can access.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSets/{dataSetId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one data set
      effect: read
      questions:
      - What does a specific data set contain?
      - Can I retrieve a single data set by ID?
      instructions:
      - text: Get data set {dataSetId}.
        slots:
          dataSetId: path.dataSetId
      - text: Show details of data set {dataSetId}.
        slots:
          dataSetId: path.dataSetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSets/{dataSetId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data set
      effect: destructive
      questions:
      - Does deleting a data set also delete the data sources inside it?
      - Can a deleted data set be recovered?
      instructions:
      - text: Delete data set {dataSetId}.
        slots:
          dataSetId: path.dataSetId
      - text: Permanently remove data set {dataSetId} and its properties.
        slots:
          dataSetId: path.dataSetId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSets/{dataSetId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a data set
      effect: write
      questions:
      - Can I rename an existing data set?
      - Which data set fields can be changed after creation?
      instructions:
      - text: Rename data set {dataSetId} to {name}.
        slots:
          dataSetId: path.dataSetId
          name: requestBody.name
      - text: Change the name of data set {dataSetId} to {name}.
        slots:
          dataSetId: path.dataSetId
          name: requestBody.name
      method: generated
      generated: '2026-10-01'