# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for AWS Lambda Layers API
  version: 1.0.0
extends: openapi/aws-lambda-layers-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: 5
- target: $.paths['/2015-03-31/layers'].get
  update:
    x-apievangelist-phrasing:
      intent: List Lambda layers and their latest version
      effect: read
      questions:
      - What Lambda layers are available in my account?
      - Can I find only layers that work with Python 3.12 or arm64?
      instructions:
      - text: List my Lambda layers with their latest versions.
      - text: List layers compatible with runtime {runtime} and architecture {architecture}.
        slots:
          runtime: query.CompatibleRuntime
          architecture: query.CompatibleArchitecture
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/layers/{LayerName}/versions'].get
  update:
    x-apievangelist-phrasing:
      intent: List the versions of one layer
      effect: read
      questions:
      - Which versions of a shared layer have been published?
      - Can I list only the versions of a layer that support a given runtime?
      instructions:
      - text: List every version of layer {layer}.
        slots:
          layer: path.LayerName
      - text: List versions of layer {layer} compatible with {runtime}.
        slots:
          layer: path.LayerName
          runtime: query.CompatibleRuntime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/layers/{LayerName}/versions'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a new layer version from a ZIP
      effect: write
      questions:
      - How do I package shared libraries as a Lambda layer?
      - Can I declare which runtimes and license a layer version supports when I publish it?
      instructions:
      - text: Publish a new version of layer {layer} from archive {content}.
        slots:
          layer: path.LayerName
          content: requestBody.Content
      - text: Publish layer {layer} from {content} for runtimes {runtimes} under license {license}.
        slots:
          layer: path.LayerName
          content: requestBody.Content
          runtimes: requestBody.CompatibleRuntimes
          license: requestBody.LicenseInfo
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/layers/{LayerName}/versions/{VersionNumber}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a layer version and its download link
      effect: read
      questions:
      - How do I download the archive behind a specific layer version?
      - What runtimes and license does a given layer version declare?
      instructions:
      - text: Get version {version} of layer {layer} with its download link.
        slots:
          layer: path.LayerName
          version: path.VersionNumber
      - text: Show the compatible runtimes of {layer} version {version}.
        slots:
          layer: path.LayerName
          version: path.VersionNumber
      method: generated
      generated: '2026-10-01'
- target: $.paths['/2015-03-31/layers/{LayerName}/versions/{VersionNumber}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a layer version
      effect: destructive
      questions:
      - How do I retire an old layer version so nobody can add it to new functions?
      - Do functions already using a layer version break when I delete it?
      instructions:
      - text: Delete version {version} of layer {layer}.
        slots:
          layer: path.LayerName
          version: path.VersionNumber
      - text: Retire layer {layer} version {version}.
        slots:
          layer: path.LayerName
          version: path.VersionNumber
      method: generated
      generated: '2026-10-01'