API Evangelist conversational phrasing for OpenAI Users API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for OpenAI Users API
  version: 1.0.0
extends: openapi/openai-users-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: 4
- target: $.paths['/organization/users'].get
  update:
    x-apievangelist-phrasing:
      intent: List the users in my organization
      effect: read
      questions:
      - Who are all the members of my organization?
      - Can I look up organization members by their email addresses?
      instructions:
      - text: List everyone in my organization.
      - text: Find organization users with emails {emails}.
        slots:
          emails: query.emails
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/users/{user_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization user's details
      effect: read
      questions:
      - What role does a specific person have in my organization?
      - Can I fetch one organization member by their user ID?
      instructions:
      - text: Show organization user {user_id}.
        slots:
          user_id: path.user_id
      - text: Check the org role of user {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/users/{user_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Change a user's role in the organization
      effect: write
      questions:
      - How do I make someone an owner of the organization?
      - Can I assign a custom role to an organization member?
      instructions:
      - text: Change user {user_id}'s organization role to {role}.
        slots:
          user_id: path.user_id
          role: requestBody.role
      - text: Assign custom role {role_id} to organization member {user_id}.
        slots:
          role_id: requestBody.role_id
          user_id: path.user_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/organization/users/{user_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from the organization
      effect: destructive
      questions:
      - How do I remove someone who has left the company from our organization?
      - Can I delete an organization member entirely?
      instructions:
      - text: Remove user {user_id} from the organization.
        slots:
          user_id: path.user_id
      - text: Delete organization member {user_id}.
        slots:
          user_id: path.user_id
      method: generated
      generated: '2026-09-26'