# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Amazon CloudFront Functions API
  version: 1.0.0
extends: openapi/cloudfront-functions-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['/2020-05-31/function'].get
  update:
    x-apievangelist-phrasing:
      intent: List CloudFront Functions
      effect: read
      questions:
      - Which CloudFront Functions have I written in this account?
      - Can I see all my edge functions in one list?
      - How do I find the functions available to attach to a distribution?
      instructions:
      - text: List all of my CloudFront Functions.
      - text: Show me every edge function in my account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2020-05-31/function'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a CloudFront Function
      effect: write
      questions:
      - How do I write a new lightweight function that runs at the edge?
      - Can I create a CloudFront Function to rewrite requests or headers?
      - What's involved in adding a new CloudFront Function?
      instructions:
      - text: Create a new CloudFront Function.
      - text: Add a new lightweight function to run at the CloudFront edge.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2020-05-31/function/{Name}'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe a CloudFront Function
      effect: read
      questions:
      - What stage and status is a particular CloudFront Function in?
      - Can I look up the metadata of one function by its name?
      - Where do I check details of an edge function I already created?
      instructions:
      - text: Describe CloudFront Function {name}.
        slots:
          name: path.Name
      - text: Show the status and metadata of function {name}.
        slots:
          name: path.Name
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2020-05-31/function/{Name}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a CloudFront Function
      effect: destructive
      questions:
      - How do I remove a CloudFront Function I no longer need?
      - Can I delete an edge function that isn't associated with any distribution?
      - Is there a way to permanently get rid of an old function?
      instructions:
      - text: Delete CloudFront Function {name}.
        slots:
          name: path.Name
      - text: Remove the edge function named {name}.
        slots:
          name: path.Name
      method: generated
      generated: '2026-10-01'