API Evangelist conversational phrasing for Lucid REST Repositories API

# 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 Repositories API
  version: 1.0.0
extends: openapi/lucid-repositories-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/repositories'].get
  update:
    x-apievangelist-phrasing:
      intent: List repositories I can view
      effect: read
      questions:
      - Which Lucid repositories do I have permission to view?
      - Can I get a list of every repository on the account I can see?
      instructions:
      - text: List all repositories I can view.
      - text: Show me my accessible Lucid repositories.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a new repository
      effect: write
      questions:
      - How do I create a new repository and assign its initial users?
      - Can I make a restricted repository and add groups to it when I create it?
      instructions:
      - text: Create a repository named {name} with users {users}.
        slots:
          name: requestBody.name
          users: requestBody.users
      - text: Create repository {name} with access type {accessType}, users {users} and groups {groups}.
        slots:
          name: requestBody.name
          accessType: requestBody.accessType
          users: requestBody.users
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get details of one repository
      effect: read
      questions:
      - What basic information can I see about a single repository?
      - Is a particular repository restricted or open, and what's it called?
      instructions:
      - text: Get repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      - text: Show details for repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List users with roles on a repository
      effect: read
      questions:
      - Who are the individual user collaborators on a repository and what roles do they hold?
      - Which people have been given a role on this repository?
      instructions:
      - text: List the user collaborators on repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      - text: Show each user's role on repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/users/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Add users or change their repository roles
      effect: write
      questions:
      - How do I add people to a repository or change the role an existing user has?
      - Can I promote a repository user to a different role?
      instructions:
      - text: Add users {users} to repository {repositoryId}.
        slots:
          users: requestBody.users
          repositoryId: path.repositoryId
      - text: Update the roles of users {users} on repository {repositoryId}.
        slots:
          users: requestBody.users
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/users/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove users from a repository
      effect: destructive
      questions:
      - Can I take individual users off a repository?
      - What's the way to revoke a person's repository role?
      instructions:
      - text: Remove users {users} from repository {repositoryId}.
        slots:
          users: requestBody.users
          repositoryId: path.repositoryId
      - text: Revoke repository {repositoryId} access for {users}.
        slots:
          repositoryId: path.repositoryId
          users: requestBody.users
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/groups'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups with access to a repository
      effect: read
      questions:
      - Which groups have member access to a repository?
      - Is a particular team group already attached to this repository?
      instructions:
      - text: List the groups on repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      - text: Show which groups are members of repository {repositoryId}.
        slots:
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/groups/add'].post
  update:
    x-apievangelist-phrasing:
      intent: Give groups member access to a repository
      effect: write
      questions:
      - How do I give a whole group member access to a repository?
      - Can I add several groups to one repository at once?
      instructions:
      - text: Add groups {groups} to repository {repositoryId}.
        slots:
          groups: requestBody.groups
          repositoryId: path.repositoryId
      - text: Give everyone in groups {groups} member access to repository {repositoryId}.
        slots:
          groups: requestBody.groups
          repositoryId: path.repositoryId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/repositories/{repositoryId}/groups/remove'].post
  update:
    x-apievangelist-phrasing:
      intent: Remove groups from a restricted repository
      effect: destructive
      questions:
      - Can I detach a group from a restricted repository?
      - What happens to group members' access when I remove their group from a repository?
      instructions:
      - text: Remove groups {groups} from repository {repositoryId}.
        slots:
          groups: requestBody.groups
          repositoryId: path.repositoryId
      - text: Take group access to restricted repository {repositoryId} away from {groups}.
        slots:
          repositoryId: path.repositoryId
          groups: requestBody.groups
      method: generated
      generated: '2026-10-01'