# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Postman Teams API
  version: 1.0.0
extends: openapi/postman-teams-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: 10
- target: $.paths['/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams in my organization
      effect: read
      questions:
      - What teams exist in my Postman organization?
      - Can I include team settings or my roles when listing teams?
      instructions:
      - text: List all teams in my organization.
      - text: List teams, {limit} per page.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a team
      effect: write
      questions:
      - How do I create a new team in my organization?
      - Can I give a new team a description when creating it?
      instructions:
      - text: Create a team named {name}.
        slots:
          name: requestBody.name
      - text: Create team {name} described as {description}.
        slots:
          name: requestBody.name
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team
      effect: read
      questions:
      - How do I look up details about one team?
      - What information comes back for a single team?
      instructions:
      - text: Get team {teamId}.
        slots:
          teamId: path.teamId
      - text: Show the details of team {teamId}.
        slots:
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/access-requests'].get
  update:
    x-apievangelist-phrasing:
      intent: List a team's pending access requests
      effect: read
      questions:
      - Who is waiting for access to my team?
      - Can I page through a team's pending join and role requests?
      instructions:
      - text: List pending access requests for team {teamId}.
        slots:
          teamId: path.teamId
      - text: Show who has asked to join team {teamId}.
        slots:
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/access-requests'].post
  update:
    x-apievangelist-phrasing:
      intent: Request access to a team
      effect: write
      questions:
      - How do I request to join a team or get a higher role?
      - Is an access request approved automatically when team discovery is on?
      instructions:
      - text: Request {role} role on team {teamId} for {entityList} because {reason}; type {requestType}.
        slots:
          role: requestBody.role
          teamId: path.teamId
          entityList: requestBody.entityList
          reason: requestBody.reason
          requestType: requestBody.requestType
      - text: File a {requestType} access request to team {teamId} for {entityList} as {role}, reason {reason}.
        slots:
          requestType: requestBody.requestType
          teamId: path.teamId
          entityList: requestBody.entityList
          role: requestBody.role
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/access-requests/{requestId}'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve or deny a team access request
      effect: write
      questions:
      - How do I approve someone's request to join my team?
      - Can I deny a pending team access request?
      instructions:
      - text: Approve access request {requestId} on team {teamId}.
        slots:
          requestId: path.requestId
          teamId: path.teamId
      - text: Respond {action} to access request {requestId} for team {teamId}.
        slots:
          action: requestBody.action
          requestId: path.requestId
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/bulk-members'].post
  update:
    x-apievangelist-phrasing:
      intent: Add or remove member roles in bulk
      effect: write
      questions:
      - Can I add and remove roles for many team members in one call?
      - What happens to members when I remove a role from a group?
      instructions:
      - text: Add roles {add} to members of team {teamId}.
        slots:
          add: requestBody.add
          teamId: path.teamId
      - text: Remove roles {remove} from members of team {teamId}.
        slots:
          remove: requestBody.remove
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/bulk-members'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove members from a team
      effect: destructive
      questions:
      - How do I remove users from my team?
      - Can I remove several team members at once?
      instructions:
      - text: Remove {entities} from team {teamId}.
        slots:
          entities: requestBody.entities
          teamId: path.teamId
      - text: Kick these users out of team {teamId}.
        slots:
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/settings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team's settings
      effect: read
      questions:
      - What settings are configured for my team?
      - Can I read a team's current configuration?
      instructions:
      - text: Get the settings of team {teamId}.
        slots:
          teamId: path.teamId
      - text: Show how team {teamId} is configured.
        slots:
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/teams/{teamId}/settings'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a team's settings
      effect: write
      questions:
      - How do I change a team's settings?
      - Can I update team configuration through the API?
      instructions:
      - text: Update the settings of team {teamId} to {settings}.
        slots:
          teamId: path.teamId
          settings: requestBody.settings
      - text: Change team {teamId}'s configuration.
        slots:
          teamId: path.teamId
      method: generated
      generated: '2026-09-26'