# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Slack Lists API
  version: 1.0.0
extends: openapi/slack-lists-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: 6
- target: $.paths['/slackLists.create'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new Slack List
      effect: write
      questions:
      - How do I create a Slack List to track tasks for a team?
      - Can I define the list's columns when I create it?
      instructions:
      - text: Create a list called {title} in channel {channel_id}.
        slots:
          title: requestBody.title
          channel_id: requestBody.channel_id
      - text: Create list {title} in {channel_id} with columns {columns}.
        slots:
          title: requestBody.title
          channel_id: requestBody.channel_id
          columns: requestBody.columns
      method: generated
      generated: '2026-09-26'
- target: $.paths['/slackLists.update'].post
  update:
    x-apievangelist-phrasing:
      intent: Rename or reconfigure a list
      effect: write
      questions:
      - Can I rename a list after it has been created?
      - What list-level settings can I change on an existing list?
      instructions:
      - text: Rename list {list_id} to {title}.
        slots:
          list_id: requestBody.list_id
          title: requestBody.title
      - text: Change the title of the whole list {list_id} to {title}.
        slots:
          list_id: requestBody.list_id
          title: requestBody.title
      method: generated
      generated: '2026-09-26'
- target: $.paths['/slackLists.items.create'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a row to a list
      effect: write
      questions:
      - How do I add a new task row to an existing list?
      - What do I pass to fill in the column values of a new item?
      instructions:
      - text: Add a new item to list {list_id} with values {column_values}.
        slots:
          list_id: requestBody.list_id
          column_values: requestBody.column_values
      - text: Create a row in {list_id} set to {column_values}.
        slots:
          list_id: requestBody.list_id
          column_values: requestBody.column_values
      method: generated
      generated: '2026-09-26'
- target: $.paths['/slackLists.items.update'].post
  update:
    x-apievangelist-phrasing:
      intent: Update a row in a list
      effect: write
      questions:
      - Can I change a field on an item that is already in a list, like marking it done?
      - Which values do I send to edit an existing list row?
      instructions:
      - text: Update item {item_id} in list {list_id} with {column_values}.
        slots:
          item_id: requestBody.item_id
          list_id: requestBody.list_id
          column_values: requestBody.column_values
      - text: Set the existing row {item_id} of {list_id} to {column_values}.
        slots:
          item_id: requestBody.item_id
          list_id: requestBody.list_id
          column_values: requestBody.column_values
      method: generated
      generated: '2026-09-26'
- target: $.paths['/slackLists.items.delete'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete a row from a list
      effect: destructive
      questions:
      - How do I remove a single item from a list?
      - Is deleting a list row permanent?
      instructions:
      - text: Delete item {item_id} from list {list_id}.
        slots:
          item_id: requestBody.item_id
          list_id: requestBody.list_id
      - text: Remove row {item_id} of {list_id}.
        slots:
          item_id: requestBody.item_id
          list_id: requestBody.list_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/slackLists.items.list'].get
  update:
    x-apievangelist-phrasing:
      intent: List the items in a list
      effect: read
      questions:
      - What rows are currently in a given list?
      - Can I page through a large list's items?
      instructions:
      - text: Show all items in list {list_id}.
        slots:
          list_id: query.list_id
      - text: Get the next {limit} rows of {list_id} after cursor {cursor}.
        slots:
          limit: query.limit
          list_id: query.list_id
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'