# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Prisma Workspaces API
  version: 1.0.0
extends: openapi/prisma-workspaces-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: 6
- target: $.paths['/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List all my workspaces
      effect: read
      questions:
      - Which workspaces do I have access to?
      - Can I see every workspace my account belongs to?
      instructions:
      - text: List my workspaces.
      - text: Show every workspace I can access.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace's billing and projects
      effect: read
      questions:
      - What is the billing status of my workspace?
      - Which projects are in a workspace along with its configuration?
      instructions:
      - text: Get workspace {workspaceId} with its projects.
        slots:
          workspaceId: path.workspaceId
      - text: Show the billing status and configuration of {workspaceId}.
        slots:
          workspaceId: path.workspaceId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/workspaces/{workspaceId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename a workspace
      effect: write
      questions:
      - How do I rename a workspace?
      - Can I change a workspace's settings after creating it?
      instructions:
      - text: Rename workspace {workspaceId} to {name}.
        slots:
          workspaceId: path.workspaceId
          name: requestBody.name
      - text: Change the name of {workspaceId} to {name}.
        slots:
          workspaceId: path.workspaceId
          name: requestBody.name
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/workspaces'].get
  update:
    x-apievangelist-phrasing:
      intent: List workspaces my token can access (v1)
      effect: read
      questions:
      - Which workspaces can my current token reach via the v1 API?
      - Can I paginate the v1 workspace list?
      instructions:
      - text: List the workspaces this token can access.
      - text: Show {limit} workspaces from the v1 API.
        slots:
          limit: query.limit
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/workspaces/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace by ID (v1)
      effect: read
      questions:
      - What does the v1 API return for one workspace?
      - Can I fetch a single workspace by ID with the v1 endpoint?
      instructions:
      - text: Get workspace {id}.
        slots:
          id: path.id
      - text: Fetch workspace {id} from the v1 API.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/v1/workspaces/{id}/subscription'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a workspace's subscription
      effect: read
      questions:
      - Which plan is my workspace subscribed to?
      - Where can I check a workspace's subscription details?
      instructions:
      - text: Get the subscription for workspace {id}.
        slots:
          id: path.id
      - text: Show what plan {id} is on.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'