# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon API Gateway V2 (HTTP and WebSocket) APIs API
  version: 1.0.0
extends: openapi/aws-api-gateway-apis-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: 4
- target: $.paths['/v2/apis'].get
  update:
    x-apievangelist-phrasing:
      intent: List HTTP and WebSocket APIs
      effect: read
      questions:
      - What HTTP and WebSocket APIs do I have in API Gateway?
      - How do I see all my v2 APIs in one list?
      instructions:
      - text: List all my HTTP and WebSocket APIs.
      - text: Show every v2 API in this account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/apis'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an HTTP or WebSocket API
      effect: write
      questions:
      - How do I create a new WebSocket API?
      - Can I quick-create an HTTP API that points straight at a target backend?
      - What route selection expression should a WebSocket API use?
      instructions:
      - text: Create a {ProtocolType} API named {Name}.
        slots:
          ProtocolType: requestBody.ProtocolType
          Name: requestBody.Name
      - text: Create an HTTP API named {Name} that proxies to {Target}.
        slots:
          Name: requestBody.Name
          Target: requestBody.Target
      - text: Create WebSocket API {Name} with protocol {ProtocolType} and route selection expression {RouteSelectionExpression}.
        slots:
          Name: requestBody.Name
          ProtocolType: requestBody.ProtocolType
          RouteSelectionExpression: requestBody.RouteSelectionExpression
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/apis/{api_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one HTTP or WebSocket API
      effect: read
      questions:
      - How do I look up the details of a single HTTP or WebSocket API?
      - What protocol and endpoint does one of my v2 APIs use?
      instructions:
      - text: Show API {api_id}.
        slots:
          api_id: path.api_id
      - text: Get the protocol type and endpoint of API {api_id}.
        slots:
          api_id: path.api_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v2/apis/{api_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an HTTP or WebSocket API
      effect: destructive
      questions:
      - How do I delete an HTTP or WebSocket API?
      - Can I remove a v2 API permanently?
      instructions:
      - text: Delete API {api_id}.
        slots:
          api_id: path.api_id
      - text: Permanently remove the WebSocket or HTTP API {api_id}.
        slots:
          api_id: path.api_id
      method: generated
      generated: '2026-10-01'