# 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 V1 (REST) Methods API
  version: 1.0.0
extends: openapi/aws-api-gateway-methods-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: 3
- target: $.paths['/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a method on a resource
      effect: read
      questions:
      - How is the GET method on one of my REST API resources configured?
      - Does a given method require an API key?
      instructions:
      - text: Show the {http_method} method on resource {resource_id} of REST API {restapi_id}.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
      - text: Check the authorization type of {http_method} on resource {resource_id} in REST API {restapi_id}.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add an HTTP method to a resource
      effect: write
      questions:
      - How do I add a POST method to a resource in my REST API?
      - Can I require an API key on a new method?
      instructions:
      - text: Add {http_method} to resource {resource_id} of REST API {restapi_id} with {authorizationType} authorization.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
          authorizationType: requestBody.authorizationType
      - text: Add an API-key-protected {http_method} method on resource {resource_id} in REST API {restapi_id} using {authorizationType}.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
          authorizationType: requestBody.authorizationType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/restapis/{restapi_id}/resources/{resource_id}/methods/{http_method}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a method from a resource
      effect: destructive
      questions:
      - How do I remove the DELETE method from a resource?
      - Can I drop an HTTP verb I no longer support on a resource?
      instructions:
      - text: Delete the {http_method} method from resource {resource_id} in REST API {restapi_id}.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
      - text: Stop supporting {http_method} on resource {resource_id} of REST API {restapi_id}.
        slots:
          http_method: path.http_method
          resource_id: path.resource_id
          restapi_id: path.restapi_id
      method: generated
      generated: '2026-10-01'