# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Trello REST Enterprises API
  version: 1.0.0
extends: openapi/trello-enterprises-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: 21
- target: $.paths['/enterprises/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Enterprise's details
      effect: read
      questions:
      - How do I fetch the details of our Trello Enterprise account?
      - Can I include the enterprise's members and Workspaces in the same response?
      instructions:
      - text: Get enterprise {id}.
        slots:
          id: path.id
      - text: Fetch enterprise {id} including members set to {members} and organizations set to {organizations}.
        slots:
          id: path.id
          members: query.members
          organizations: query.organizations
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/auditlog'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Enterprise's audit log
      effect: read
      questions:
      - Where can I pull the audit log of admin actions in our Enterprise?
      - Does the enterprise audit log need an admin token?
      instructions:
      - text: Get the audit log for enterprise {id}.
        slots:
          id: path.id
      - text: Pull enterprise {id}'s audit log actions so I can export them to a sheet.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/admins'].get
  update:
    x-apievangelist-phrasing:
      intent: List an Enterprise's admins
      effect: read
      questions:
      - Who are the admins of our Enterprise?
      - Can I list only the enterprise admin members?
      instructions:
      - text: List the admin members of enterprise {id}.
        slots:
          id: path.id
      - text: Show enterprise {id}'s admins with fields {fields}.
        slots:
          id: path.id
          fields: query.fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/signupUrl'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an Enterprise's signup URL
      effect: read
      questions:
      - How do I get the link people use to sign up to our Enterprise?
      - Can I set a return URL on the enterprise signup link?
      instructions:
      - text: Get the signup URL for enterprise {id}.
        slots:
          id: path.id
      - text: Get enterprise {id}'s signup link that returns users to {returnUrl}.
        slots:
          id: path.id
          returnUrl: query.returnUrl
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/members/query'].get
  update:
    x-apievangelist-phrasing:
      intent: Query an Enterprise's users by license and activity
      effect: read
      questions:
      - Which enterprise users are licensed versus board guests only?
      - Can I find users who have been inactive since a certain date?
      - How many users come back per page when I query enterprise users?
      instructions:
      - text: Query enterprise {id} users where licensed is {licensed}.
        slots:
          id: path.id
          licensed: query.licensed
      - text: Find users in enterprise {id} inactive since {inactiveSince}.
        slots:
          id: path.id
          inactiveSince: query.inactiveSince
      - text: Get the next page of enterprise {id} users after cursor {cursor}.
        slots:
          id: path.id
          cursor: query.cursor
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List an Enterprise's members
      effect: read
      questions:
      - How do I list every member of our Enterprise with sorting and paging?
      - Can I filter enterprise members with a SCIM-style query?
      instructions:
      - text: List the members of enterprise {id}.
        slots:
          id: path.id
      - text: List enterprise {id} members matching SCIM filter {filter}.
        slots:
          id: path.id
          filter: query.filter
      - text: Get {count} members of enterprise {id} starting at index {startIndex}.
        slots:
          count: query.count
          id: path.id
          startIndex: query.startIndex
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/members/{idMember}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one member of an Enterprise
      effect: read
      questions:
      - How do I look up a single person inside our Enterprise?
      - Can I see which Workspaces and boards one enterprise member belongs to?
      instructions:
      - text: Get member {idMember} of enterprise {id}.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Show enterprise {id} member {idMember} with board fields {board_fields}.
        slots:
          id: path.id
          idMember: path.idMember
          board_fields: query.board_fields
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/transferrable/organization/{idOrganization}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check if one Workspace can move to an Enterprise
      effect: read
      questions:
      - Can this particular Workspace be transferred into our Enterprise?
      - How do I check transfer eligibility for a single organization?
      instructions:
      - text: Check whether Workspace {idOrganization} can be transferred to enterprise {id}.
        slots:
          idOrganization: path.idOrganization
          id: path.id
      - text: Tell me if organization {idOrganization} is transferrable into enterprise {id}.
        slots:
          idOrganization: path.idOrganization
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/transferrable/bulk/{idOrganizations}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check which of several Workspaces can be transferred
      effect: read
      questions:
      - Given a list of Workspaces, which ones can be moved into our Enterprise?
      - Is there a bulk transfer-eligibility check for many organizations at once?
      instructions:
      - text: Check which of Workspaces {idOrganizations} can be transferred to enterprise {id}.
        slots:
          idOrganizations: path.idOrganizations
          id: path.id
      - text: Bulk check transfer eligibility of organizations {idOrganizations} for enterprise {id}.
        slots:
          idOrganizations: path.idOrganizations
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/${id}/enterpriseJoinRequest/bulk'].put
  update:
    x-apievangelist-phrasing:
      intent: Decline Workspace requests to join an Enterprise
      effect: destructive
      questions:
      - How do I decline join requests from Workspaces asking to be added to our Enterprise?
      - Can I reject enterprise join requests from many organizations in one call?
      instructions:
      - text: Decline the enterprise join requests from Workspaces {idOrganizations} for enterprise {id}.
        slots:
          idOrganizations: query.idOrganizations
          id: path.id
      - text: Reject the request of organization {idOrganizations} to join enterprise {id}.
        slots:
          idOrganizations: query.idOrganizations
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/claimableOrganizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Workspaces an Enterprise can claim
      effect: read
      questions:
      - Which Workspaces is our Enterprise able to claim?
      - Can I search claimable Workspaces by name or by how recently they were active?
      instructions:
      - text: List the claimable Workspaces for enterprise {id}.
        slots:
          id: path.id
      - text: Find claimable Workspaces named {name} for enterprise {id}.
        slots:
          name: query.name
          id: path.id
      - text: Show up to {limit} claimable organizations for enterprise {id} active since {activeSince}.
        slots:
          limit: query.limit
          id: path.id
          activeSince: query.activeSince
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/pendingOrganizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List Workspaces pending for an Enterprise
      effect: read
      questions:
      - Which Workspaces are waiting to be added to our Enterprise?
      - Can I filter pending organizations by when they were last active?
      instructions:
      - text: List the pending Workspaces for enterprise {id}.
        slots:
          id: path.id
      - text: Show pending organizations for enterprise {id} inactive since {inactiveSince}.
        slots:
          id: path.id
          inactiveSince: query.inactiveSince
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/tokens'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an auth token for an Enterprise
      effect: write
      questions:
      - How do I generate an API token scoped to our Enterprise?
      - Can I make an enterprise token that expires after one day or 30 days?
      instructions:
      - text: Create an auth token for enterprise {id}.
        slots:
          id: path.id
      - text: Create a token for enterprise {id} that expires in {expiration}.
        slots:
          id: path.id
          expiration: query.expiration
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List the Workspaces in an Enterprise
      effect: read
      questions:
      - Which Workspaces already belong to our Enterprise?
      - Can I page through an enterprise's organizations 100 at a time?
      instructions:
      - text: List the Workspaces in enterprise {id}.
        slots:
          id: path.id
      - text: Get {count} organizations of enterprise {id} starting at {startIndex}.
        slots:
          count: query.count
          id: path.id
          startIndex: query.startIndex
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/organizations'].put
  update:
    x-apievangelist-phrasing:
      intent: Transfer a Workspace into an Enterprise
      effect: write
      questions:
      - How do I move a Workspace into our Enterprise?
      - Does a successful response mean the organization transfer already finished under AdminHub?
      instructions:
      - text: Transfer Workspace {idOrganization} into enterprise {id}.
        slots:
          idOrganization: query.idOrganization
          id: path.id
      - text: Move organization {idOrganization} under enterprise {id}.
        slots:
          idOrganization: query.idOrganization
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/members/{idMember}/licensed'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant or revoke a member's Enterprise license
      effect: write
      questions:
      - How do I give an enterprise member one of our available licenses?
      - What happens to a member when I revoke their enterprise license?
      instructions:
      - text: Set the enterprise license for member {idMember} in enterprise {id} to {value}.
        slots:
          idMember: path.idMember
          id: path.id
          value: query.value
      - text: Assign a license to member {idMember} of enterprise {id} by setting licensed to {value}.
        slots:
          idMember: path.idMember
          id: path.id
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/members/{idMember}/deactivated'].put
  update:
    x-apievangelist-phrasing:
      intent: Deactivate a member of an Enterprise
      effect: destructive
      questions:
      - How do I deactivate someone in our Enterprise when they leave the company?
      - Is enterprise member deactivation available if we use AdminHub?
      instructions:
      - text: Deactivate member {idMember} of enterprise {id} by setting deactivated to {value}.
        slots:
          idMember: path.idMember
          id: path.id
          value: query.value
      - text: Set the deactivated flag on enterprise {id} member {idMember} to {value}.
        slots:
          id: path.id
          idMember: path.idMember
          value: query.value
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/admins/{idMember}'].put
  update:
    x-apievangelist-phrasing:
      intent: Make a member an Enterprise admin
      effect: write
      questions:
      - How do I promote a member to admin of our Enterprise?
      - Can I grant enterprise admin rights through the API?
      instructions:
      - text: Make member {idMember} an admin of enterprise {id}.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Promote {idMember} to enterprise admin in {id}.
        slots:
          idMember: path.idMember
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/admins/{idMember}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member's Enterprise admin role
      effect: destructive
      questions:
      - How do I take away someone's enterprise admin rights?
      - Can I demote an enterprise admin back to a regular member?
      instructions:
      - text: Remove member {idMember} as an admin of enterprise {id}.
        slots:
          idMember: path.idMember
          id: path.id
      - text: Revoke enterprise admin rights from {idMember} in {id}.
        slots:
          idMember: path.idMember
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/organizations/{idOrg}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a Workspace from an Enterprise
      effect: destructive
      questions:
      - How do I take a Workspace out of our Enterprise?
      - Can I detach an organization from an enterprise account?
      instructions:
      - text: Remove Workspace {idOrg} from enterprise {id}.
        slots:
          idOrg: path.idOrg
          id: path.id
      - text: Detach organization {idOrg} from enterprise {id}.
        slots:
          idOrg: path.idOrg
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/enterprises/{id}/organizations/bulk/{idOrganizations}'].get
  update:
    x-apievangelist-phrasing:
      intent: Bulk accept Workspaces into an Enterprise
      effect: write
      questions:
      - How do I accept several Workspaces into our Enterprise in one request?
      - Is bulk-adding organizations to an enterprise asynchronous under AdminHub?
      instructions:
      - text: Accept Workspaces {idOrganizations} into enterprise {id}.
        slots:
          idOrganizations: path.idOrganizations
          id: path.id
      - text: Bulk add organizations {idOrganizations} to enterprise {id}.
        slots:
          idOrganizations: path.idOrganizations
          id: path.id
      method: generated
      generated: '2026-09-26'