# 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 Source API
  version: 1.0.0
extends: openapi/lucid-data-source-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: 8
- target: $.paths['/dataSources'].get
  update:
    x-apievangelist-phrasing:
      intent: List my data sources
      effect: read
      questions:
      - Which data sources do I have access to in Lucid?
      - Can I page through my data sources in ranges?
      instructions:
      - text: List all my data sources.
      - text: Show data sources {start} through {end}.
        slots:
          start: query.start
          end: query.end
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSources'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data source
      effect: write
      questions:
      - How do I create a new data source to link data into diagrams?
      - Do I get a grant automatically on a data source I create?
      instructions:
      - text: Create a data source named {name}.
        slots:
          name: requestBody.name
      - text: Create data source {name} with adapter type {adapterType}.
        slots:
          name: requestBody.name
          adapterType: requestBody.adapterType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSources'].head
  update:
    x-apievangelist-phrasing:
      intent: Count my data sources
      effect: read
      questions:
      - How many data sources can I access?
      - Is there a way to get only the total number of data sources?
      instructions:
      - text: Count my data sources.
      - text: Tell me how many data sources I have access to.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSources/{dataSourceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a data source
      effect: read
      questions:
      - What details does a single data source have?
      - When are a data source's link parameters returned?
      instructions:
      - text: Get data source {dataSourceId}.
        slots:
          dataSourceId: path.dataSourceId
      - text: Show the details of data source {dataSourceId}.
        slots:
          dataSourceId: path.dataSourceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSources/{dataSourceId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a data source and everything in it
      effect: destructive
      questions:
      - Does deleting a data source also remove its collections and items?
      - Can a deleted data source be recovered?
      instructions:
      - text: Delete data source {dataSourceId}.
        slots:
          dataSourceId: path.dataSourceId
      - text: Permanently remove data source {dataSourceId} and its collections.
        slots:
          dataSourceId: path.dataSourceId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/dataSources/{dataSourceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a data source or change its adapter
      effect: write
      questions:
      - How do I rename a data source?
      - Can I change the adapter type of an existing data source?
      instructions:
      - text: Rename data source {dataSourceId} to {name}.
        slots:
          dataSourceId: path.dataSourceId
          name: requestBody.name
      - text: Set data source {dataSourceId}'s adapter type to {adapterType}.
        slots:
          dataSourceId: path.dataSourceId
          adapterType: requestBody.adapterType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/adapter/csv'].put
  update:
    x-apievangelist-phrasing:
      intent: Replace a data source's data from a CSV
      effect: write
      questions:
      - How do I refresh an existing data source with a new CSV file?
      - Can I overwrite just one collection from a CSV upload?
      instructions:
      - text: Overwrite data source {dataSource} with CSV {file}.
        slots:
          dataSource: query.dataSource
          file: requestBody.file
      - text: Replace the items in collection {collection} of data source {dataSource} with CSV {file}.
        slots:
          collection: query.collection
          dataSource: query.dataSource
          file: requestBody.file
      method: generated
      generated: '2026-10-01'
- target: $.paths['/adapter/csv'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a data source from a CSV file
      effect: write
      questions:
      - Can I upload a CSV to make a brand-new data source?
      - How are columns named when a CSV becomes a new data source?
      instructions:
      - text: Create a new data source from CSV {file}.
        slots:
          file: requestBody.file
      - text: Upload {file} as a new CSV data source.
        slots:
          file: requestBody.file
      method: generated
      generated: '2026-10-01'