# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Lucid REST Teams API
  version: 1.0.0
extends: openapi/lucid-teams-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/v1/teams'].get
  update:
    x-apievangelist-phrasing:
      intent: List teams I can access
      effect: read
      questions:
      - Which Lucid teams do I have access to?
      - Can I list only the teams I am a member of?
      - As an admin, can I see every team on the account?
      instructions:
      - text: List my teams.
      - text: List teams with filter {filter}.
        slots:
          filter: query.filter
      - text: List all account teams requesting as {Lucid-Request-As}.
        slots:
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a team with members
      effect: write
      questions:
      - How do I create a new team with a set of members?
      - Am I added automatically to a team I create as an admin?
      instructions:
      - text: Create a {type} team called {name} with users {users}.
        slots:
          type: requestBody.type
          name: requestBody.name
          users: requestBody.users
      - text: Create team {name} of type {type} for users {users}, requesting as {Lucid-Request-As}.
        slots:
          name: requestBody.name
          type: requestBody.type
          users: requestBody.users
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a team's details
      effect: read
      questions:
      - What are the details of a specific team?
      - Can an admin view any team on the account by ID?
      instructions:
      - text: Get team {id}.
        slots:
          id: path.id
      - text: Show team {id} as {Lucid-Request-As}.
        slots:
          id: path.id
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a team
      effect: write
      questions:
      - How do I rename an existing team?
      - Which teams am I allowed to update without admin permissions?
      instructions:
      - text: Rename team {id} to {name}.
        slots:
          id: path.id
          name: requestBody.name
      - text: Change team {id}'s name to {name} as {Lucid-Request-As}.
        slots:
          id: path.id
          name: requestBody.name
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List members of a team
      effect: read
      questions:
      - Who is on a given team?
      - Can I page through the members of a large team?
      instructions:
      - text: List the members of team {id}.
        slots:
          id: path.id
      - text: Show who belongs to team {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}/users/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Add users to a team
      effect: write
      questions:
      - How do I add people to a team with a role?
      - Can I add several users to a team at once?
      instructions:
      - text: Add users {users} to team {id}.
        slots:
          users: requestBody.users
          id: path.id
      - text: Put users {users} on team {id} as {Lucid-Request-As}.
        slots:
          users: requestBody.users
          id: path.id
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}/users/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove users from a team
      effect: destructive
      questions:
      - Can I take members off a team?
      - What do I need to remove someone from a team I don't manage?
      instructions:
      - text: Remove users {users} from team {id}.
        slots:
          users: requestBody.users
          id: path.id
      - text: Take users {users} off team {id} as {Lucid-Request-As}.
        slots:
          users: requestBody.users
          id: path.id
          Lucid-Request-As: header.Lucid-Request-As
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}/archive'].post
  update:
    x-apievangelist-phrasing:
      intent: Archive a team
      effect: destructive
      questions:
      - How do I make a team inactive?
      - Can an admin archive any team on the account?
      instructions:
      - text: Archive team {id}.
        slots:
          id: path.id
      - text: Deactivate team {id} by archiving it.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/teams/{id}/restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore an archived team
      effect: write
      questions:
      - Can I bring back a team I archived?
      - Is restoring a previously archived team possible through the API?
      instructions:
      - text: Restore archived team {id}.
        slots:
          id: path.id
      - text: Reactivate team {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-10-01'