# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Boards API
  version: 1.0.0
extends: openapi/trello-boards-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: 43
- target: $.paths['/boards'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a board
      effect: write
      questions:
      - How do I create a new Trello board with a name and description?
      - Can I make a board inside a specific workspace and set it private or public?
      - Is it possible to create a board without the default lists?
      instructions:
      - text: Create a board named {name}.
        slots:
          name: query.name
      - text: Make a new board {name} in workspace {idOrganization} with permission level {permissionLevel}.
        slots:
          name: query.name
          idOrganization: query.idOrganization
          permissionLevel: query.prefs_permissionLevel
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a board's details
      effect: read
      questions:
      - How do I fetch a board along with its lists, cards and labels in one call?
      - What information can I get about a single board?
      instructions:
      - text: Show me board {id}.
        slots:
          id: path.id
      - text: Get board {id} including its nested lists, cards and members.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a board's settings
      effect: write
      questions:
      - How do I rename a board or change its description?
      - Can I close a board or move it to a different workspace?
      - Where do I rename the color labels on a board?
      instructions:
      - text: Rename board {id} to {name}.
        slots:
          id: path.id
          name: query.name
      - text: Set the permission level of board {id} to {permissionLevel}.
        slots:
          id: path.id
          permissionLevel: query.prefs/permissionLevel
      - text: Name the green label on board {id} {green}.
        slots:
          id: path.id
          green: query.labelNames/green
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a board
      effect: destructive
      questions:
      - How do I permanently delete a board?
      - Is deleting a board reversible, or should I close it instead?
      instructions:
      - text: Permanently delete board {id}.
        slots:
          id: path.id
      - text: Destroy board {id} and everything on it.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List recent activity on a board
      effect: read
      questions:
      - How do I see the recent activity feed for a board?
      - Can I cap how many board activity events come back?
      instructions:
      - text: Show the last {limit} activity events on board {id}.
        slots:
          limit: query.limit
          id: path.id
      - text: List board {id} activity of type {filter}.
        slots:
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/cards'].get
  update:
    x-apievangelist-phrasing:
      intent: List all cards on a board
      effect: read
      questions:
      - How do I get every card on a board?
      - Can I choose which card fields come back when listing a board's cards?
      instructions:
      - text: List all cards on board {id}.
        slots:
          id: path.id
      - text: Get the cards on board {id} with only the fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/cards/{filter}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a board's cards by status
      effect: read
      questions:
      - How do I get only the open or only the archived cards on a board?
      - Which status filters can I apply to a board's cards?
      instructions:
      - text: List the {filter} cards on board {id}.
        slots:
          filter: path.filter
          id: path.id
      - text: Show only archived cards on board {id}, filter {filter}.
        slots:
          id: path.id
          filter: path.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/checklists'].get
  update:
    x-apievangelist-phrasing:
      intent: List all checklists on a board
      effect: read
      questions:
      - How do I pull every checklist across a whole board?
      - Can I see all checklists on a board without going card by card?
      instructions:
      - text: List every checklist on board {id}.
        slots:
          id: path.id
      - text: Get all board {id} checklists.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/labels'].get
  update:
    x-apievangelist-phrasing:
      intent: List labels defined on a board
      effect: read
      questions:
      - Which labels are available on a board?
      - How do I get a board's label names and colors?
      instructions:
      - text: List the labels on board {id}.
        slots:
          id: path.id
      - text: Show up to {limit} labels defined on board {id}.
        slots:
          limit: query.limit
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/labels'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a label on a board
      effect: write
      questions:
      - How do I add a new colored label to a board?
      - Can I create a label with a custom name and color?
      instructions:
      - text: Create a {color} label called {name} on board {id}.
        slots:
          color: query.color
          name: query.name
          id: path.id
      - text: Add label {name} with color {color} to board {id}.
        slots:
          name: query.name
          color: query.color
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/lists'].get
  update:
    x-apievangelist-phrasing:
      intent: List the lists on a board
      effect: read
      questions:
      - How do I get all the columns on a board?
      - Can I fetch a board's lists together with their cards?
      instructions:
      - text: List the lists on board {id}.
        slots:
          id: path.id
      - text: Get board {id}'s lists with their cards included ({cards}).
        slots:
          id: path.id
          cards: query.cards
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/lists'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a list to a board
      effect: write
      questions:
      - How do I add a new column to a board?
      - Can I choose where a new list appears on the board?
      instructions:
      - text: Add a list named {name} to board {id}.
        slots:
          name: query.name
          id: path.id
      - text: Create list {name} on board {id} at position {pos}.
        slots:
          name: query.name
          id: path.id
          pos: query.pos
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List members of a board
      effect: read
      questions:
      - Who are the members of a board?
      - How do I get everyone who has access to a board?
      instructions:
      - text: List the members of board {id}.
        slots:
          id: path.id
      - text: Show who belongs to board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/members'].put
  update:
    x-apievangelist-phrasing:
      intent: Invite someone to a board by email
      effect: write
      questions:
      - How do I invite a person to a board using their email address?
      - Can I invite someone to a board as an admin or observer?
      instructions:
      - text: Invite {email} to board {id}.
        slots:
          email: query.email
          id: path.id
      - text: Invite {email} to board {id} as a {type}.
        slots:
          email: query.email
          id: path.id
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/members/{idMember}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a board member's role
      effect: write
      questions:
      - How do I make an existing board member an admin?
      - Can I downgrade a board member to observer by their member id?
      instructions:
      - text: Make member {idMember} a {type} on board {id}.
        slots:
          idMember: path.idMember
          type: query.type
          id: path.id
      - text: Change the role of {idMember} on board {id} to {type}.
        slots:
          idMember: path.idMember
          id: path.id
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/members/{idMember}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from a board
      effect: destructive
      questions:
      - How do I kick someone off a board?
      - Can I revoke a person's access to a board?
      instructions:
      - text: Remove member {idMember} from board {id}.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Revoke {idMember}'s access to board {id}.
        slots:
          idMember: path.idMember
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/memberships'].get
  update:
    x-apievangelist-phrasing:
      intent: List board membership records
      effect: read
      questions:
      - How do I see each board member's membership type?
      - Can I filter a board's memberships to admins only?
      instructions:
      - text: List the membership records for board {id}.
        slots:
          id: path.id
      - text: Show board {id} memberships filtered to {filter}.
        slots:
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/{field}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one field of a board
      effect: read
      questions:
      - Can I read just a board's name or description without the whole board?
      - How do I fetch a single property from a board?
      instructions:
      - text: Get only the {field} of board {id}.
        slots:
          field: path.field
          id: path.id
      - text: Read the {field} property on board {id}.
        slots:
          field: path.field
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{boardId}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: Page through a board's actions by date
      effect: read
      questions:
      - How do I page through a board's full action history between two dates?
      - Can I get board actions since a certain date with their reactions?
      instructions:
      - text: Get actions on board {boardId} since {since}.
        slots:
          boardId: path.boardId
          since: query.since
      - text: Fetch page {page} of board {boardId} actions before {before}.
        slots:
          page: query.page
          boardId: path.boardId
          before: query.before
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{boardId}/boardStars'].get
  update:
    x-apievangelist-phrasing:
      intent: List stars on a board
      effect: read
      questions:
      - Who has starred a board?
      - Can I see only my own star on a board?
      instructions:
      - text: List the stars on board {boardId}.
        slots:
          boardId: path.boardId
      - text: Show board {boardId} stars filtered by {filter}.
        slots:
          boardId: path.boardId
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/customFields'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom field definitions on a board
      effect: read
      questions:
      - Which custom fields are defined on a board?
      - How do I get a board's custom field definitions?
      instructions:
      - text: List the custom field definitions on board {id}.
        slots:
          id: path.id
      - text: Show what custom fields board {id} has.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/lists/{filter}'].get
  update:
    x-apievangelist-phrasing:
      intent: List a board's lists by open or closed
      effect: read
      questions:
      - How do I get only the archived lists on a board?
      - Can I filter a board's lists to open ones via a path filter?
      instructions:
      - text: Filter board {id} columns down to only {filter} ones.
        slots:
          filter: path.filter
          id: path.id
      - text: Show archived columns on board {id} using filter {filter}.
        slots:
          id: path.id
          filter: path.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/memberships/{idMembership}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a board membership's type
      effect: write
      questions:
      - How do I change a membership's type using the membership id rather than the member id?
      - Can I switch a board membership from normal to admin?
      instructions:
      - text: Set membership {idMembership} on board {id} to type {type}.
        slots:
          idMembership: path.idMembership
          id: path.id
          type: query.type
      - text: Update board {id} membership record {idMembership} to {type}.
        slots:
          id: path.id
          idMembership: path.idMembership
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/emailPosition'].put
  update:
    x-apievangelist-phrasing:
      intent: Set where emailed cards land in a list
      effect: write
      questions:
      - Can cards I email to a board go to the top of the list instead of the bottom?
      - How do I change my emailPosition preference on a board?
      instructions:
      - text: Put emailed cards at the {value} of the list on board {id}.
        slots:
          value: query.value
          id: path.id
      - text: Set my email position pref on board {id} to {value}.
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/idEmailList'].put
  update:
    x-apievangelist-phrasing:
      intent: Set the default list for emailed cards
      effect: write
      questions:
      - Which list do cards created by email-to-board go into, and can I change it?
      - How do I route emailed cards to a different list?
      instructions:
      - text: Send email-to-board cards on board {id} to list {value}.
        slots:
          id: path.id
          value: query.value
      - text: Make {value} the default email list for board {id}.
        slots:
          value: query.value
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/showSidebar'].put
  update:
    x-apievangelist-phrasing:
      intent: Show or hide the board sidebar
      effect: write
      questions:
      - Can I hide the sidebar on a board for myself?
      - How do I toggle my showSidebar preference?
      instructions:
      - text: Set sidebar visibility on board {id} to {value}.
        slots:
          id: path.id
          value: query.value
      - text: Hide the whole sidebar for me on board {id} ({value}).
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/showSidebarActivity'].put
  update:
    x-apievangelist-phrasing:
      intent: Show or hide sidebar activity
      effect: write
      questions:
      - Can I stop the activity feed from showing in a board's sidebar?
      - How do I toggle the showSidebarActivity preference?
      instructions:
      - text: Set the sidebar activity feed on board {id} to {value}.
        slots:
          id: path.id
          value: query.value
      - text: Turn off the activity section of the sidebar on board {id} ({value}).
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/showSidebarBoardActions'].put
  update:
    x-apievangelist-phrasing:
      intent: Show or hide sidebar board actions
      effect: write
      questions:
      - Can I hide the board actions menu in the sidebar?
      - How do I change the showSidebarBoardActions preference?
      instructions:
      - text: Set sidebar board actions on board {id} to {value}.
        slots:
          id: path.id
          value: query.value
      - text: Collapse the board-actions block of the sidebar on board {id} ({value}).
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/myPrefs/showSidebarMembers'].put
  update:
    x-apievangelist-phrasing:
      intent: Show or hide sidebar members
      effect: write
      questions:
      - Can I hide the member avatars in a board's sidebar?
      - How do I toggle showSidebarMembers for a board?
      instructions:
      - text: Set sidebar members display on board {id} to {value}.
        slots:
          id: path.id
          value: query.value
      - text: Hide member faces from the sidebar of board {id} ({value}).
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a board with Power-Ups or copied content
      effect: write
      questions:
      - Can I create a board that copies another board and keeps its cards?
      - How do I enable Power-Ups on a board at creation time?
      - Is there a create-board call that sets invitation and card cover preferences?
      instructions:
      - text: Copy board {idBoardSource} into a new board {name}, keeping {keepFromSource}.
        slots:
          idBoardSource: query.idBoardSource
          name: query.name
          keepFromSource: query.keepFromSource
      - text: Create board {name} with Power-Ups {powerUps} enabled.
        slots:
          name: query.name
          powerUps: query.powerUps
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/calendarKey/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a board calendar key
      effect: write
      questions:
      - How do I regenerate the calendar feed key for a board?
      - Can I reset a board's calendar key if the feed URL leaked?
      instructions:
      - text: Generate a new calendar key for board {id}.
        slots:
          id: path.id
      - text: Reset the calendar feed key on board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/emailKey/generate'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a board email key
      effect: write
      questions:
      - How do I get a fresh email-to-board address key?
      - Can I rotate a board's email key so old addresses stop working?
      instructions:
      - text: Generate a new email key for board {id}.
        slots:
          id: path.id
      - text: Rotate the email-to-board key on board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/idTags'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a tag to a board
      effect: write
      questions:
      - How do I tag a board so it groups with others in a workspace?
      - Can I attach a tag id to a board?
      instructions:
      - text: Add tag {value} to board {id}.
        slots:
          value: query.value
          id: path.id
      - text: Tag board {id} with {value}.
        slots:
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/markAsViewed'].post
  update:
    x-apievangelist-phrasing:
      intent: Mark a board as viewed
      effect: write
      questions:
      - How do I record that I've viewed a board?
      - Can I mark a board as seen to clear its unread state?
      instructions:
      - text: Mark board {id} as viewed.
        slots:
          id: path.id
      - text: Flag board {id} as seen by me.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/boardPlugins'].get
  update:
    x-apievangelist-phrasing:
      intent: List enabled Power-Ups on a board
      effect: read
      questions:
      - Which Power-Ups are currently turned on for a board?
      - How do I see a board's enabled Power-Ups only?
      instructions:
      - text: List the enabled Power-Ups on board {id}.
        slots:
          id: path.id
      - text: Show which Power-Ups are switched on for board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/boardPlugins'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable a Power-Up on a board
      effect: write
      questions:
      - How do I turn on a Power-Up for a board?
      - Can an integration enable its own Power-Up on a board?
      instructions:
      - text: Enable Power-Up {idPlugin} on board {id}.
        slots:
          idPlugin: query.idPlugin
          id: path.id
      - text: Switch on plugin {idPlugin} for board {id}.
        slots:
          idPlugin: query.idPlugin
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/boardPlugins/{idPlugin}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable a Power-Up on a board
      effect: destructive
      questions:
      - How do I turn off a Power-Up on a board?
      - Can I disable a Power-Up without removing it from the workspace?
      instructions:
      - text: Disable Power-Up {idPlugin} on board {id}.
        slots:
          idPlugin: path.idPlugin
          id: path.id
      - text: Switch off plugin {idPlugin} for board {id}.
        slots:
          idPlugin: path.idPlugin
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/plugins'].get
  update:
    x-apievangelist-phrasing:
      intent: List Power-Ups available on a board
      effect: read
      questions:
      - What Power-Ups are on a board, enabled or available?
      - Can I filter a board's Power-Up list by status?
      instructions:
      - text: List the Power-Ups on board {id} filtered by {filter}.
        slots:
          id: path.id
          filter: query.filter
      - text: Show all Power-Up plugins associated with board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/exports'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a board export
      effect: write
      questions:
      - How do I export a board, including its attachments?
      - Can I run two exports of the same board at once?
      instructions:
      - text: Start an export of board {id}.
        slots:
          id: path.id
      - text: Export board {id} with attachments {attachments}.
        slots:
          id: path.id
          attachments: query.attachments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/exports/{idExport}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a board export's status
      effect: read
      questions:
      - How do I know when a board export has finished?
      - What is the status of an export I started?
      instructions:
      - text: Check the status of export {idExport} for board {id}.
        slots:
          idExport: path.idExport
          id: path.id
      - text: Is export {idExport} of board {id} ready yet; report its state.
        slots:
          idExport: path.idExport
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/exports/{idExport}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a board export
      effect: destructive
      questions:
      - How do I delete an export file I no longer need?
      - Is deleting a board export a hard or soft delete?
      instructions:
      - text: Delete export {idExport} of board {id}.
        slots:
          idExport: path.idExport
          id: path.id
      - text: Discard board {id} export {idExport}.
        slots:
          id: path.id
          idExport: path.idExport
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/exports/{idExport}/download'].get
  update:
    x-apievangelist-phrasing:
      intent: Download a finished board export
      effect: read
      questions:
      - How do I download the file from a completed board export?
      - What happens if I try to download an export that isn't ready?
      instructions:
      - text: Download export {idExport} of board {id}.
        slots:
          idExport: path.idExport
          id: path.id
      - text: Grab the exported file {idExport} for board {id}.
        slots:
          idExport: path.idExport
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/boards/{id}/exports/mostRecent'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a board's latest successful export
      effect: read
      questions:
      - Where do I find the most recent successful export of a board?
      - Can I get the latest board export without knowing its id?
      instructions:
      - text: Get the most recent export of board {id}.
        slots:
          id: path.id
      - text: Show the latest successful backup export for board {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'