# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello Organizations API
  version: 1.0.0
extends: openapi/trello-organizations-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: 26
- target: $.paths['/organizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new Workspace
      effect: write
      questions:
      - How do I create a new Trello Workspace from code?
      - Can I set a description and website when I create a Workspace?
      instructions:
      - text: Create a Workspace called {displayName}.
        slots:
          displayName: query.displayName
      - text: Create a Workspace named {displayName} with description {desc} and website {website}.
        slots:
          displayName: query.displayName
          desc: query.desc
          website: query.website
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a Workspace's details
      effect: read
      questions:
      - How do I look up a Workspace by its id or short name?
      - What details come back for an organization, like its display name and website?
      instructions:
      - text: Get the details of Workspace {id}.
        slots:
          id: path.id
      - text: Show me organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a Workspace's name, description or website
      effect: write
      questions:
      - Can I rename a Workspace or change its URL short name?
      - How do I update the website and description shown on an organization?
      instructions:
      - text: Rename Workspace {id} to {displayName}.
        slots:
          id: path.id
          displayName: query.displayName
      - text: Set the website of organization {id} to {website}.
        slots:
          id: path.id
          website: query.website
      - text: Change Workspace {id}'s description to {desc}.
        slots:
          id: path.id
          desc: query.desc
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Permanently delete a Workspace
      effect: destructive
      questions:
      - What happens to the boards when I delete a Workspace?
      - How do I permanently delete an organization I no longer need?
      instructions:
      - text: Delete Workspace {id} and all its boards.
        slots:
          id: path.id
      - text: Permanently remove organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/boards'].get
  update:
    x-apievangelist-phrasing:
      intent: List the boards in a Workspace
      effect: read
      questions:
      - Which boards live inside a given Workspace?
      - Can I list only the open or only the closed boards of an organization?
      instructions:
      - text: List all boards in Workspace {id}.
        slots:
          id: path.id
      - text: Show Workspace {id}'s boards filtered to {filter}.
        slots:
          id: path.id
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List the members of a Workspace
      effect: read
      questions:
      - Who belongs to a particular Trello Workspace?
      - How do I get the list of people in an organization?
      instructions:
      - text: List the members of Workspace {id}.
        slots:
          id: path.id
      - text: Show everyone who belongs to organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members'].put
  update:
    x-apievangelist-phrasing:
      intent: Invite someone to a Workspace by email
      effect: write
      questions:
      - How do I add a new person to a Workspace using their email address?
      - Can I invite someone as an admin rather than a normal member when adding by email?
      instructions:
      - text: Invite {email} with full name {fullName} to Workspace {id}.
        slots:
          email: query.email
          fullName: query.fullName
          id: path.id
      - text: Add {fullName} at {email} to organization {id} as a {type} member.
        slots:
          fullName: query.fullName
          email: query.email
          id: path.id
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members/{idMember}'].put
  update:
    x-apievangelist-phrasing:
      intent: Change a member's role in a Workspace
      effect: write
      questions:
      - How do I promote an existing Workspace member to admin?
      - Can I change someone's membership type in an organization from admin back to normal?
      instructions:
      - text: Make member {idMember} a {type} in Workspace {id}.
        slots:
          idMember: path.idMember
          type: query.type
          id: path.id
      - text: Change the membership type of {idMember} in organization {id} to {type}.
        slots:
          idMember: path.idMember
          id: path.id
          type: query.type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members/{idMember}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from a Workspace
      effect: destructive
      questions:
      - How do I remove someone from a Workspace but leave them on its boards?
      - Can I kick a person out of an organization through the API?
      instructions:
      - text: Remove member {idMember} from Workspace {id}.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Take {idMember} out of organization {id} only, not its boards.
        slots:
          idMember: path.idMember
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/{field}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a single field of a Workspace
      effect: read
      questions:
      - Can I fetch just one property of a Workspace, such as its display name?
      - What's the lightest call to read a single organization field?
      instructions:
      - text: Get the {field} field of Workspace {id}.
        slots:
          field: path.field
          id: path.id
      - text: Read only {field} from organization {id}.
        slots:
          field: path.field
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/actions'].get
  update:
    x-apievangelist-phrasing:
      intent: List activity actions in a Workspace
      effect: read
      questions:
      - How do I see the recent activity that happened in a Workspace?
      - Is there an activity feed for everything done inside an organization?
      instructions:
      - text: List the actions on Workspace {id}.
        slots:
          id: path.id
      - text: Show recent activity for organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/exports'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Workspace's CSV exports
      effect: read
      questions:
      - Where can I find the exports that were already generated for a Workspace?
      - How do I check whether a Workspace CSV export has finished?
      instructions:
      - text: List the existing exports for Workspace {id}.
        slots:
          id: path.id
      - text: Show the status of organization {id}'s CSV exports.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/exports'].post
  update:
    x-apievangelist-phrasing:
      intent: Start a CSV export of a Workspace
      effect: write
      questions:
      - How do I kick off a CSV export of an entire Workspace?
      - Can I include attachments in a Workspace export?
      instructions:
      - text: Start a CSV export for Workspace {id}.
        slots:
          id: path.id
      - text: Export organization {id} to CSV with attachments set to {attachments}.
        slots:
          id: path.id
          attachments: query.attachments
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/memberships'].get
  update:
    x-apievangelist-phrasing:
      intent: List the memberships of a Workspace
      effect: read
      questions:
      - How do I see each person's membership type in a Workspace, admin or normal?
      - Can I filter Workspace memberships to only admins or only deactivated members?
      instructions:
      - text: List the memberships of Workspace {id}.
        slots:
          id: path.id
      - text: Show organization {id}'s memberships filtered to {filter} with member details {member}.
        slots:
          id: path.id
          filter: query.filter
          member: query.member
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/memberships/{idMembership}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one membership record of a Workspace
      effect: read
      questions:
      - How do I fetch a single membership in a Workspace by its membership id?
      - Can I see the member's profile along with one specific organization membership?
      instructions:
      - text: Get membership {idMembership} of Workspace {id}.
        slots:
          idMembership: path.idMembership
          id: path.id
      - text: Show membership {idMembership} in organization {id} including the member set to {member}.
        slots:
          idMembership: path.idMembership
          id: path.id
          member: query.member
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/pluginData'].get
  update:
    x-apievangelist-phrasing:
      intent: Get Workspace-scoped Power-Up plugin data
      effect: read
      questions:
      - Where is the pluginData that Power-Ups store at the Workspace level?
      - Can I read organization-scoped plugin data for my Power-Up?
      instructions:
      - text: Get the organization-scoped pluginData for Workspace {id}.
        slots:
          id: path.id
      - text: Show Power-Up plugin data stored on organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/tags'].get
  update:
    x-apievangelist-phrasing:
      intent: List a Workspace's board collections
      effect: read
      questions:
      - How do I see the collections (tags) that group boards in a Workspace?
      - What board collections exist in an organization?
      instructions:
      - text: List the collections of Workspace {id}.
        slots:
          id: path.id
      - text: Show the tags used to group boards in organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/tags'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a tag in a Workspace
      effect: write
      questions:
      - How do I add a new tag to an organization for grouping boards?
      - Can I create a Workspace tag through the API?
      instructions:
      - text: Create a new tag in Workspace {id}.
        slots:
          id: path.id
      - text: Add a tag to organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members/{idMember}/deactivated'].put
  update:
    x-apievangelist-phrasing:
      intent: Deactivate or reactivate a Workspace member
      effect: write
      questions:
      - How do I deactivate a Workspace member without removing them?
      - Can I reactivate someone who was deactivated in an organization?
      instructions:
      - text: Set deactivated to {value} for member {idMember} in Workspace {id}.
        slots:
          value: query.value
          idMember: path.idMember
          id: path.id
      - text: Reactivate member {idMember} in organization {id} by setting deactivated to {value}.
        slots:
          idMember: path.idMember
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/logo'].post
  update:
    x-apievangelist-phrasing:
      intent: Set a Workspace's logo
      effect: write
      questions:
      - How do I upload a logo image for a Workspace?
      - Can I replace an organization's logo through the API?
      instructions:
      - text: Set the logo of Workspace {id} to {file}.
        slots:
          id: path.id
          file: query.file
      - text: Upload {file} as the logo for organization {id}.
        slots:
          file: query.file
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/logo'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Workspace's logo
      effect: destructive
      questions:
      - How do I delete the logo from a Workspace?
      - Can I clear an organization's logo back to the default?
      instructions:
      - text: Delete the logo from Workspace {id}.
        slots:
          id: path.id
      - text: Clear organization {id}'s logo.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/members/{idMember}/all'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from a Workspace and all its boards
      effect: destructive
      questions:
      - How do I remove someone from a Workspace and every board in it at once?
      - Can I fully offboard a person from all of an organization's boards in one call?
      instructions:
      - text: Remove member {idMember} from Workspace {id} and all of its boards.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Offboard {idMember} from organization {id} including every Workspace board.
        slots:
          idMember: path.idMember
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/prefs/associatedDomain'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Workspace's associated Google Apps domain
      effect: destructive
      questions:
      - How do I unlink the Google Apps domain associated with a Workspace?
      - Can I remove the associated domain setting from an organization?
      instructions:
      - text: Remove the associated Google Apps domain from Workspace {id}.
        slots:
          id: path.id
      - text: Unlink organization {id} from its associated domain.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/prefs/orgInviteRestrict'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Workspace's email domain invite restriction
      effect: destructive
      questions:
      - How do I let people outside our email domain be invited to a Workspace again?
      - Can I delete the invite restriction that limits who can join an organization?
      instructions:
      - text: Remove the email domain invite restriction on Workspace {id}.
        slots:
          id: path.id
      - text: Lift the restriction on who can be invited to organization {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/tags/{idTag}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a Workspace tag
      effect: destructive
      questions:
      - How do I delete a tag I created in a Workspace?
      - Can I remove a board collection tag from an organization?
      instructions:
      - text: Delete tag {idTag} from Workspace {id}.
        slots:
          idTag: path.idTag
          id: path.id
      - text: Remove the collection tag {idTag} in organization {id}.
        slots:
          idTag: path.idTag
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organizations/{id}/newBillableGuests/{idBoard}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a board for new billable guests
      effect: read
      questions:
      - Will adding guests to this board make them billable to our Workspace?
      - How do I check whether a board has new billable guests?
      instructions:
      - text: Check whether board {idBoard} has new billable guests for Workspace {id}.
        slots:
          idBoard: path.idBoard
          id: path.id
      - text: List new billable guests on board {idBoard} in organization {id}.
        slots:
          idBoard: path.idBoard
          id: path.id
      method: generated
      generated: '2026-09-26'