# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Lists API
  version: 1.0.0
extends: openapi/trello-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: 11
- target: $.paths['/lists'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a list on a board
      effect: write
      questions:
      - How do I create a new list on a board by passing the board id?
      - Can I copy an existing list when creating a new one?
      instructions:
      - text: Create a list called {name} on board {idBoard}.
        slots:
          name: query.name
          idBoard: query.idBoard
      - text: Copy list {idListSource} into a new list {name} on board {idBoard}.
        slots:
          idListSource: query.idListSource
          name: query.name
          idBoard: query.idBoard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a list's details
      effect: read
      questions:
      - How do I look up one list by its id?
      - What fields does a Trello list have?
      instructions:
      - text: Show me list {id}.
        slots:
          id: path.id
      - text: Get the fields {fields} of list {id}.
        slots:
          fields: query.fields
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a list's name, position or status
      effect: write
      questions:
      - How do I change several things about a list at once, like its name and position?
      - Can I subscribe to a list so I get notified of changes?
      instructions:
      - text: Update list {id} with name {name} at position {pos}.
        slots:
          id: path.id
          name: query.name
          pos: query.pos
      - text: Subscribe me to list {id} ({subscribed}).
        slots:
          id: path.id
          subscribed: query.subscribed
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List activity on a list
      effect: read
      questions:
      - What has happened on a list recently?
      - Can I filter a list's activity by action type?
      instructions:
      - text: Show the activity on list {id}.
        slots:
          id: path.id
      - text: List {filter} actions on list {id}.
        slots:
          filter: query.filter
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/board'].get
  update:
    x-apievangelist-phrasing:
      intent: Find the board a list belongs to
      effect: read
      questions:
      - Which board is a list on?
      - How do I get a list's parent board?
      instructions:
      - text: Get the board that list {id} belongs to.
        slots:
          id: path.id
      - text: Tell me the parent board of list {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/cards'].get
  update:
    x-apievangelist-phrasing:
      intent: List the cards in a list
      effect: read
      questions:
      - How do I get all the cards in one column?
      - What cards are sitting in a given list right now?
      instructions:
      - text: List the cards in list {id}.
        slots:
          id: path.id
      - text: Show every card in column {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/archiveAllCards'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive every card in a list
      effect: destructive
      questions:
      - How do I archive all the cards in a list at once?
      - Can I clear out a Done column in one call?
      instructions:
      - text: Archive all cards in list {id}.
        slots:
          id: path.id
      - text: Clear out column {id} by archiving its cards.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/moveAllCards'].post
  update:
    x-apievangelist-phrasing:
      intent: Move every card in a list elsewhere
      effect: write
      questions:
      - How do I move all the cards from one list to another?
      - Can I bulk move a list's cards to a list on a different board?
      instructions:
      - text: Move all cards from list {id} to list {idList} on board {idBoard}.
        slots:
          id: path.id
          idList: query.idList
          idBoard: query.idBoard
      - text: Bulk transfer the cards in {id} into list {idList} of board {idBoard}.
        slots:
          id: path.id
          idList: query.idList
          idBoard: query.idBoard
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/closed'].put
  update:
    x-apievangelist-phrasing:
      intent: Archive or unarchive a list
      effect: write
      questions:
      - How do I archive a list?
      - Can I bring back an archived list?
      instructions:
      - text: Archive list {id}.
        slots:
          id: path.id
      - text: Set the archived state of list {id} to {value}.
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/idBoard'].put
  update:
    x-apievangelist-phrasing:
      intent: Move a list to another board
      effect: write
      questions:
      - How do I move a whole list to a different board?
      - Do a list's cards come along when I move it to another board?
      instructions:
      - text: Move list {id} to board {value}.
        slots:
          id: path.id
          value: query.value
      - text: Relocate column {id} onto board {value}.
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/lists/{id}/{field}'].put
  update:
    x-apievangelist-phrasing:
      intent: Set a single field on a list
      effect: write
      questions:
      - How do I rename a list by setting just its name field?
      - Can I change one property of a list without sending the others?
      instructions:
      - text: Set the {field} of list {id} to {value}.
        slots:
          field: path.field
          id: path.id
          value: query.value
      - text: Rename list {id} by setting field {field} to {value}.
        slots:
          id: path.id
          field: path.field
          value: query.value
      method: generated
      generated: '2026-09-26'